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Section 1 
System Requirements 

This section is intended for readers who wish to select a computer system on 
which to use WordStar/ and those who wish to determine whether WordStar can be 
used on their present system. 

WordStar's system requirements are an 8080/8085/Z80 Microcomputer with adequate 
RAM, floppy disk drives, a dO: terminal or video board, and the CP/M operating 
system. You will normally also want a printer, or access to another system 
with a printer and an operational WordStar. 

DISK DRIVES 

Two floppy disk drives are highly recommended, to allow you to back up files 
conveniently and set up new working disks, but a single-drive system caa be 
used if you have a means of copying files from diskette to diskette and the 
disk capacity of one disk is sufficient to support the essential WordStar files 
(about 70K) and leave two times the size of the biggest file you will want to 
edit as unused space on the disk. 

TERHINAL OR VIDEO BOARD 

You may use any CRT terminal or video board providing a display area of at 
least 16 lines by 40 columns (and not larger than 120 lines by 250 columns)* 
capable of displaying ASCII codes 20 thru 7E hex and capable of directly 
positioning the cursor by sending line and column. The terminal must be acces- 
sible as the "console" device under CP/M; certain video boards (see Section 5) 
may also be accessed on a direct memory mapped basis for fastest display. 

CRT's with line insert, line delete, and character-by^-character inverse video 
or bright/dim highlighting may provide enhanced performance with WordStar; 
direct-memory^-mapped video boards provide the best performance. 

Selecting a Terminal 

TO be able to run WordStar, a terminal must have absolute cursor positioning. 
In addition, WordStar must "know" the control sequences used by the particular 
terminal or video board to position the cursor and perform other (optional) 
functions; these are set by the "installation" procedure. Section 2. WordStar 
may be installed for many common terminal types via a simple menu selection. 

Serial Interface 

As a serial interface for the terminal, you may select the MicroPro "I/O 
Master". S-100 interface board. This board's 32-character "FIFO" buffer permits 
the fastest text entry even during disk accesses and simultaneous printing and 
editing. Further, this board allows using the inexpensive "OEM" versions of 
the various manufacturers* daisy printers (next page). (Centronic's port and 
interrupt handler may also be usedJ 

* Theoretical limit. The actual limit is determined by the RAM available 
on your system. 
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RANDOM ACCESS MENOR? 

For a terminal with a 24 x 80 or smaller screen, including space for the opera- 
ting system (CP/M) and text work areas, a minimum of 45K PAM is required. To 
edit and print at the same time, 3K more BAM is required. Terminals with 
unusually large screens require, in addition to one byte for each of the first 
1S20 characters, one additional byte for each character position on the screen 
in excess of 1920 total characters. If the board requires more than 2096 
bytes, WordStar will require 2 bxtsa for every byte over 2096. (If you have 
one of the video boards that WordStar can access in direct memory mapped mode, 
2K less RAM is adequate.) 

While WordStar is perfectly usable in the minimum amount of RAM, additional RAM 
is recommended for systems which will be used extensively for documents longer 
than a few pages. Additional RAM increases the amount of text that can be held 
in RAM simultaneously; thus, more RAM speeds editing and increases productivity 
by reducing disk access. (Additional RAM does not affect maximum file size; 
file size is limited by the capacity of the diskette, not of the RAMJ 

PRINTERS 

WordStar can be installed to drive virtually any printer. The features avail- 
able are limited to those supported by the printer. Special installation is 
required to access some features of some printers. Underlining, boldface 
(multi-strike method), and double strike require a printer that can overprint 
(most printers have this capability). Microspace justification, continuously 
variable line height, continuously variable character pitch, subscripts, super- 
scripts, and boldface (offset and restrike method) require a daisy wheel or 
other printer capable of incremental motion. 

High-Quality Printers 

The following printers are fully supported by WordStar and the installation 
program supplied with WordStar. All of WordStar's capabilities including bi- 
directional printing are available with these printers; simple menu selections 
(detailed in Section 3) will install WordStar for these printers: 

Serial Printers: 

Diablo 1610/1620 
Diablo 1640/1650 
Qume Sprint 5 
NEC Spinwriter 5510/5520 

OEM Printers* : 

NEC 5500D 

Diablo Hy-Type II 1345, 1355, 1355WP 

Qume Sprint 3 (with Diablo-compatible cable adapter) 

* MicroPro "I/O Master" Interface Board (or equivalent) required 

The MicroPro "I/O Master" S-100 interface board allows use of the less-expen- 
sive "(3E!M" daisy printers and provides simple installation, maximum printing 
speed, and good response when editing while printing. The NEC 5500D printer 
(or equivalent) with a PA-1 board may be used for either an Altos or a TRS-80 
II terminal. 
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Other Printers 

All other printers (TTeletype-like" or "non-daisy" printers) are treated in two 
classes, those that can backspace and those that cannot. The ability to return 
the carriage without feeding the paper is assumed; if this ability is lacking, 
overprint lines, boldface, and double strike will not work, but WordStar will 
be otherwise fimctional. WordStar can be installed for a basic "Teletype-like" 
printer of either class via selection from a menu. Through special installa- 
tion, additional printer capabilities of the printer can be supported: choice 
of two character pitches, two ribbon colors, and up to four other special 
functions. 

Suggested Setups 

For a large installation, you will probably want a line printer for fast draft 
printout and daisy wheel printers for high quality final copy printout. When 
multiple work stations are used, it is practical to omit the printer (commonly 
the most expensive hardware item) on some, using these as editing stations only 
and moving documents on diskette to one of the printing systems. 

WordStar can access the printer as the CP/M "list device" or by direct I/O to 
the printer interface ports. Provision is available for the "ETX/ACK" communi- 
cations protocol required to run serial daisy wheel printers at maximum speed 
without buffer overrun. 

Sections 2-5 provide details on installing WordStar to work with your terminal 
and printer. Sections 6-8 provide details on special installations. Special 
installations are required for setting up systems not handled by an ordinary 
installation and for modifying the operation of WordStar features (see 
"Features and Defaults" below). For a complete description of situations where 
a special installation is required, see Sections 6, 7, and 8. 

FEATURES AND DEFAULTS 

With an ordinary installation, WordStar comes up with all features set a 
certain way by default. When you run the INSTALL program, as described in 
Sections 2-5, you will automatically get the defaults. However, it is possible 
to alter the standard defaults, i.e., to reset the defaults for WordStar 
features to other values of your own choosing. Table 1-1 shows the standard 
defaults that you will get if you make no alterations. 

If you would like further information on setting up a custom WordStar system, 
you may purchase WordStar CostomizatiGn Notes from MicroPro. 
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Table l-l. Defaults for Parameters 



Item 




IionriX)cuDent Hode 


Left Margin 


Column 1 


Column 1 


Right Margin 


Column 65 

(80-column screen) 
Column 60 

(64'<;olumn screen) 


Column 65 

(80-column screen) 
Column 60 

(64-coluran screen) 


Variable Tab Stops 


Cols. 6, 11, 16r..., 56 


Cols. 9, 17r 25r...f 73 


Variable Tabbing 


CN 


OFF 


Word Wrap 


CN 


OFF 


Justification 


ON 


OFF 


Ruler Display 


CN 


OFF 


Page Break Display 


ON 


Inoperative 


Print Control Display 


CN 


CN 


Soft Hyphen Entry 


OFF 


OFF 


Hyphen-Help 


CN 


OFF 
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Section 2 
Installation Considerations 

The "installation" procedure sets up WordStar to work with your particular 
terminal and printer. This procedure enables one distributed WordStar version 
to work with a wide variety of peripheral equipment. For most cases, instal- 
lation is accomplished by entering choices from menus f as described in Sections 
2-5. For exceptional terminals and printers r and for achieving refinements in 
installationr there are extensive provisions for "patching" by a programmer as 
described in Sections 6-8. 

Special versions of WordStar are distributed for a few microcomputer systems 
with unusual requirements. These special versions are described in AppeiuSix A; 
any special installation or operation considerations relating to a particular 
version are given there. Check Appendix B; if your system is shown, follow any 
instructions given there. 

TERMINAL INSTALLATION CONSIDERATIONS 

The INSTALL program supplied with WordStar can automatically supply the neces- 
sary control codes for many of the most common terminalSr including these: 

Compucolor 8001G Beehive 150 / Cromemco 3100 

Flashwriter I Flashwriter II 

Hazeltine 1500 Hewlett-Packard 2621 A/P 

IMSAI VIO Inf oton I-lOO 

Lear-Siegler ADM-3A Lear-Siegler ADM-31 

MicroTerm ACT-IV MicroTerm ACT-V 

Perkin-Elmer 550 (Bantam) Processor Tech Sol 

Soroc IQ-120 SWTPC CT-82 

TEC Model 571 TeleVideo 912/920 

Visual 200 

If your terminal is not shown, you will need to consult the manufacturer's 
manual to determine its control codes for cursor positioning (and possibly for 
other functions), then "patch" them in as described in Sections 6-8. For hints 
regarding some specific terminals, such as the settings required for option 
switches, check Appendix C If your terminal is shown, follow any instructions 
given there. 

PRINTER INSTALLATION CONSIDERATIONS 

Daisy Printers and Teletype-like Printers 

WordStar supports two classes of printers: daisy wheel and similar printers and 
"Teletype-like" printers (i.e., most other printers). We will discuss the 
general characteristics and capabilities of these classes of printers here, and 
also other considerations relating to printer installation. Appendix D gives 
additional specific information for each particular printer supported. Section 
3 describes the actual printer installation procedure used once you know what 
choices you wish to make. 

2-1 



Section 2 Installation Considerations 

naTSV WHFPT. awn .gTMTTJVl? PRTTfTRPfi 

Daisy wheel printers are printers capable o£ incremental horizontal and verti- 
cal motion, allowing use o£ variable line height, variable character spacing, 
subscripts, and the rest of WordStar's print enhancements as described in the 
Reference Manual. "Microspace Justification" is automatically implemented when 
printing on a daisy wheel or similar printer. Since the control sequences are 
different for each daisy wheel or similar printer, WordStar must be specifi- 
cally installed for the printer that is to be used. WordStar can be installed 
for one of the following daisy wheel printers via "menu" selection as will be 
detailed in Section 3: 

NEC 5500D OEM printer with MicroPro "I/O Master" Interface Board 

Diablo 1300 series Hy-Type II OEM printer with MicroPro "I/O Master" 

Qume Sprint 3 OEM printer with adapter and MicroPro "I/O Master" 

Diablo 1610/1620* 

Diablo 1640/1650 

Qume Sprint 5 

NEC Spinwriter 5510/5520 

* Also used for the the NEC 5500D with a PA-1 board on Altos or TRS-80 II 

Selecting one of the above printers from the menu installs WordStar to make use 
of all capabilities of that printer. WordStar will print bi-directionally if 
any of the above printers is selected. 

"OEM" Daigy Printers 

WordStar may be installed to drive the NEC 5500D, Diablo Hy-type II 1300 
series, and Qume Sprint 3 (with cable adapter) OEM printers through the Micro- 
Pro "I/O Master" interface board with a single menu selection (as will be 
described in Section 3). For Altos and 11^-80 II terminals, WordStar may also 
be installed to drive the NEC 5500D through the PA-1 interface board. Users of 
OEM printers and the "I/O Master" interface board may disregard the rest of 
this section and go on to Section 3. 

"Serial" Daisy Printers 

The printers not noted as "OEM" in the above list are usually supplied with a 
"Serial" interface. When using a serial daisy printer with WordStar, you will 
generally wish to set the printer and the computer interface to 1200 baud (120 
characters per second), the highest transmission speed supported by these 
printers. Such printers operate far below their speed capability with WordStar 
when set to 300 baud or less. Use of 1200 baud generally requires use of a 
"communications protocol" to prevent loss of characters; use of a communica- 
tions protocol usually precludes access to the printer as the "CP/M List De- 
vice". Read "Communications Protocols" and "Printer Drivers" later in this 
section carefully and check Appendix D with regard to your printer, before 
attempting to install WordStar to drive one of these printers at 1200 baud. 

"TBT.l?ryPF!-LTT?B" PRINTERS 

This class includes almost all printers other than daisy wheel printers— any 
printer that prints the ASCII printing characters (codes 20 through 7E hex) and 
res^nds to the carriage return and line feed codes, but not the more sophisti- 
cated printing features. Using a Teletype-like printer, WordStar can under- 
line, strike out, double strike, and overprint. Boldface is printed with three 
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strikes (or as specified by a customer through patching). Subscripts and super- 
scripts are printed in the line below or above i£ that line is blank, otherwise 
in the line in which they appear. Variable line height is not available. A 
choice o£ two cheuracter pitches and two ribbon colors is available through 
special installationr described in Section 7. Right-justification of printout 
on a Teletype-like printer is accomplished by inserting whole spaces between 
wordSr as on the screen during editing. 

A daisy wheel or similar printer will operate with WordStar installed for a 
Teletype-like printer, but only the Teletype-like printer capabilities will be 
available, and bi-directional printing will not occur. 

Two menu selections are provided for Teletype-like printers: 

A. Any Teletype-like Printer 

B. Teletype-like Printer that Can Backspace 

Selecting A or B above installs WordStar to make use of the basic capabilities 
common to all Teletype-like printers. Use of additional capabilities of speci- 
fic printers, such as character pitch change or ribbon color change, can be 
enabled via special installation as detailed in Section 7. The backspacing 
selection produces faster printing of underline, boldface, double strike, and 
backspace for moderate usage. (For a larger amount of underlining, etc. in a 
given line, overprinting becomes faster.) Use selection B if you know your 
printer can backspace; if you are in doubt as to whether your printer can 
backspace. Selection A will work. 

Other Printers 

Generally, WordStar is installed for printers that are not Teletype-like (nor 
among the specific daisy wheel and similar printers supported) 1:^ making one 
of the two '"Teletype-like" selections in the installation dialog. Additional 
patches, if required, are covered in Section 7. 

Both of the "Teletype-like" printer selections (A and B above) assume the 
printer will return carriage without advancing to the next line when sent a 
carriage return code that is not followed by a line feed code. If your printer 
cannot return its carriage without advancing to the next line^ but can back- 
space (Selection B), overprint lines will not print correctly, but WordStar 
will be otherwise operational. (Overprint lines are discussed in the Reference 
Manual.) If your printer can neither return the carriage without feeding to 
the next line nor backspace, use Selection A and avoid use of underline, 
strikeout, boldface, double strike, backspace, and overprint lines. 

If your printer can return the carriage independently of advancing the paper, 
but does these functions under control of characters other than the standard 
ASCII carriage return and line feed codes, WordStar can be made fully 
operational with your printer by patching the appropriate control strings as 
described in Section 7. 

Another selection on the Printer Menu, "Half-Line Feed Printers", is intended 
to facilitate installation for printers that can advance the paper one-half 
line at a time; the half-line advance is utilized in printing subscripts and 
superscripts. After making this selection, patches will probably be required. 
See Section 7 ("Custom Printer Installation") along with Appendices D and E. 
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Communications Protocols 

A "communications protocol" is a convention whereby a (serial) printer tells 
WordStar when to stop transmitting characters (while those already received by 
the printer are being printed) and when to resume transmitting. 

Communications protocols as discussed here are not pertinent to "OEM" or 
Centronic's interfaced printers; users with the NEC 5500D, NEC 5530, Diablo Hy- 
type II r or Qume Sprint 3 (3EM printers interfaced with either the MicroPro "I/O 
Master" board or the PA-1 board may disregard this subsection. 

A communications protocol is not necessary with a (serial) daisy wheel or 
similar printers interfaced at 150 baud or less, and generally not at 300 baud. 
However r if you have such a printer interfaced at that speed, you will want to 
change it to 1200 baud when you discover how slowly it prints. 

Unless hardware and cabling options are available and have been implemented, a 
communications protocol is always necessary with a serial daisy wheel or simi- 
lar printer interfaced at 1200 baud. If no communications protocol is instal- 
led, the printer's buffer will overflow and characters will be lost. 

We will describe the available communications protocols in general here; see 
Appendix D for specific notes relating to your printer. The protocols sup- 
ported by WordStar are "EIX/ACK protocol" and "XDci^FF protocol". Both commu- 
nications protocols require that the computer be able to receive characters 
from the printer as well as transmit characters to the printer. This compli- 
cates installation when a communications protocol is to be used, since the 
normal method of accessing a printer under CP/M, the "list device", provides 
only for transmission of characters from the computer to the printer. 

six/Acz: pigrocQL 

under this protocol, WordStar sends a "message" consisting of a specified 
maximum number of characters, followed by an "ETX" character (03). After 
printing all characters up to the ETIX, the printer transmits an "ACK" character 
(06H) back to the computer, thus signalling WordStar that another message may 
be transmitted. All daisy wheel and similar printers supported by WordStar can 
use this protocol, though some printers require specific optioning to activate 
it. See Appendix D and the printer manufacturer's documentation. 

XON/XQFF gRPTOOOL 

Under this protocol, the printer transmits an "XDFF" character (DC3 ASCZI code) 
to the computer when WordStar should stop transmitting characters, then trans- 
mits an "XON" character (DCl ASCII code) when transmission may resume. 
XDN/XDFF protocol is supported as an alternate protocol by some daisy wheel and 
similar printers; use XDN/XDPP instead of ETX/ACK only if other considerations, 
such as other software to be run on the same computer, necessitate its use, or 
if you have an unusual printer that will perform XCN/XOPP but not EIX/ACK. 
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Printer Drivers 

Users with NEC 5500Dr Diablo H5?^-Type Ilr and Qume Sprint 3 OEM printers inter- 
faced with the MicroPro "I/O Master" board may disregard this subsection 
(selection of OEM printer / I/O Master interface combination during installa- 
tion automatically selects the required driver). Users who wish to drive a 
serial daisy printer at 1200 baud must read this section carefully. Users of 
NEC 5500D OEM printers with PA-1 boards for Altos and TRS-80 II terminals 
should use the list device (see below) • 

The normal method whereby a program accesses the printer under CP/M — the 
"list output device" — does not support receiving characters from the printer, 
as required by "communications protocols" (preceding subsection). 

AlsOf the list output device does not allow the program to determine whether 
the printer is busy or ready to receive another character via software. Deter- 
mination of whether the prdLnter is busy ("Printer busy test") is not essential 
to WordStar operationr but is desirable as it improves keyboard response and 
printer speed during concurrent editing and printing. 

To handle communications protocols and printer busy tests r and accommodate 
special cases, WordStar provides several methods for accessing the printer. 
Each method of accessing the printer is termed a printer driver, when instal- 
ling WordStar, one of the following printer drivers may be chosen. The para- 
graphs that follow discuss each printer driver in detail. Selecting the desired 
printer driver is accomplished during installation by selecting from a menu 
(Section 3). 

CP/M "Lis t Output" Device (LST:) 

CP/M "TTY:" Console Device 

CP/M "CRT:" Console Device 

Port Driver (direct input/output by WordStar) 

Custom Subroutines 

GP/M LIgr CXnPPT DEVICE CLSTs) 

This driver outputs characters to the printer via the printer driver in your 
operating system. The list output device is the simplest way to access your 
printer if your printer requires no communications protocol (preceding sub- 
section) and no printer busy test is desired. (There is a patch that allows 
Spinware to check busy for faster operation from WordStarJ If your printer 
requires a communications protocol (as all daisy wheel and similar printers 
interfaced at 1200 baud do), you may wish to choose another of WordStar's 
printer driver options, or you may wish to make use of WordStar's provisions 
for installation of a user-supplied list device character input routine. (See 
Section 7.) 

de XP/n list output device" choice will work correctly from WbrdStar only if 
your o^eratiiig system can already aakgat characters to the printer as the list 
device. Suitable installation of the operating system is often necessary to 
enable it to drive a specific printer, in some cases, the computer dealer or 
manufacturer sullies a CP/M with a suitable printer driver already installed. 
In other cases, the user must install a suitable subroutine in the "BIOS" 
portion of the operating system if the system is to drive the printer. Of 
course, such system installation is not necessary for WordStar use unless 
WordStar is installed to do printer output via the CP/M list device. 
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In many systems r the "list output device" (LST:) is a "logical" device which 
can be assigned to one of several "physical" devices. If tiiis is true of your 
system (check your system manual), you must either give the necessary command 
or provide the necessary system setup (SETDP.COM or CCNFIGXOM) to assign LST: 
to the desired printer device before you can print with a WordStar installed to 
use the CP/M LIST DEVICE, 

C0NFIG.COM r C0NFIGDRE.COM and related files allow you to set up LIST DEVICE 
conditions via a kind of menu. Dsually you have to run the "CONFIG" program 
and answer the questions (CONFIG is short for "configure" which is similar to 
MicroPro's INSTALL program). Look up the procedures for running one of these 
programs in your CP/M manual. 

A more universal set-up is that procedure available via the STaT.COM program. 
Typing STAT LST:=LPT: will assign the LIST DEVICE to the physical device and 
its driver associated with the LPT:. This nearly always works, but is 
transient (ie. is lost vhen the system is re-booted); while the CCNFICSDPE set- 
up tends to be permanent (either optionally or by definition.) 
To verify that your operating system drives your printer and that LST: is 
indeed assigned to the printer, type control-P at the system prompt (A», then 
type additional characters. All characters typed on the console (and 
everything that appears on the display) should be printed on the printer until 
you type another control-P. This is an unqualified test of proper LIST DEVICE 
operation. 

CP/M has no provision for inputting characters from the list output device, as 
required by the communications protocols, nor does it have a uniform provision 
for a printer busy test. However, WordStar provides for installation of user- 
supplied printer character input and printer busy test subroutines (such as 
those found in Spinware) for use in association with CP/M list output device 
printer output. (See Section 7J 

Csuxtlon 

Do not attempt to install or use code li the operating ssfstsn to 
implement EQC/IOC protocol when driving a Diablo or Qume daisy wheel 
printer. For WordStar to work with these printers under this proto- 
col, the protocol must be executed by WordStar. 

ALTERNKTS airgyTTirffi 

In many versions of CP/M the "console" is a logical device (CCN:) which can be 
assigned to any one of four physical devices, usually called "TTY:", "CPT:", 
"BAT:", and "DLl". The terminal used by the operator is one of the "physical" 
consoles and must be the active one when WordStar is invoked; WordStar can 
access the printer as another of the consoles. WordStar can be installed to 
access the printer as the TTY: or CRT: console device by making an appropriate 
selection at the Printer Driver menu (Section 3). The other two physical con- 
soles can be accessed via patching (Section 7). 

Accessing the printer as an alternate console allows inputting characters from 
the printer, as required by communications protocols, without system software 
modifications or patching. The TTY: or CRT: printer driver is often the most 
convenient printer driver choice when a communications protocol is required, as 
by a daisy wheel printer set to 1200 baud. Accessing the printer as an alter- 
nate console does not provide a printer busy test unless the user installs his 
own subroutine (Section 7). 
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'Wyt Alternate Console Device Printer Driver 

This driver accesses the printer as the "TTY:" console device. This driver 
will support conmiunications protocols and may be used i£ your CP/M operating 
system supports multiple consoles and the terminal from which WordStar is 
operated is not the "TEY:" device. 

CSTi Alternate Console Device Printer Driver 

Similar to the preceding/ this driver accesses the printer as the "CKT:" con- 
sole device. This driver will support communications protocols and may be used 
if your CP/M st^^xDrts multiple consoles and the terminal from which WordStar is 
operated is not the "CRT:" device. 

PORT DRIVEN 

WordStar's "^rt driver" bypasses the operating system and does input-output 
directly to the printer interface, thereby eliminating any complications 
introduced by the CP/M operating system- The port driver supports character 
input from the printer and includes a printer busy test; the port driver thus 
handles communications protocols (preceding subsection) and allows WordStar to 
provide the best keyboard response during concurrent editing and printing. 

Installation of the port driver requires that you specify whether your printer 
interface uses "I/O ports" or is "memory mapped". If in doubtr assume "I/O 
ports" as this case is most common. Installation of the port driver requires 
determination of the output data port number (or memory address if memory 
mapped) , output status port number f output status bitSr and, if a communica- 
tions protocol is to be used, the input data port, input status port number, 
and iz^t status bits. If you don't icnow the port numbers for your interface, 
the WordStar installation program can be directed to search for the ports (as 
will be detailed later). 

Note 

E3^erience has shown that the DETERMINE function is extremely limited 
as a tool for determining available ports. For Dynabute, Altos, and 
Vector Graphics ports, refer to Sections 4 and 8 and Appendix F. Jf 
you don't find the information there, ask your dealer about supple- 
mentary i^lication Notes. 

If your printer interface involves more than one output data port (or memory 
mapped location) , one output status port, one input data port, and one input 
status port, WordStar's port driver is not applicable. Otherwise, if you know 
your printer's port numbers (or memory mapped addresses) and status bits, or 
can determine them in your system with the installation program's automatic 
search features, the port driver is the best printer driver choice where a 
communications protocol is required or a printer busy test is desired. 

cnsTCM snBRcmrrNES prtoter driver 

Choosing this printer driver selection causes WordStar to call user-coded, 
user-installed subroutines to output to the printer, input from the printer 
(for communications protocols) , and determine whether the printer is busy. 
This choice may be used when the CP/M list device won't work (e.g., because a 
communications protocol, and thus printer character input, is required) and the 
port driver won't work (e.g., because an unusual printer uses several data or 
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status ports). 

After selecting "Custom Subroutines" on the INSTALL menu, it is up to you to 
code and install the necessary routines* See Appendix E for listings of the 
area in which to install your code. Section 7 for discussion. 

Sunmary of Printer-Related 
Installation Selections 

ammmrm wrm i/o master 

OEM Printer with MicroPro I/O Master Interface Board: No complications dis- 
cussed in this section are pertinent. Choose "I/O Master / OEM Printer" at the 
INSTALL program's printer menu (as will be described in Section 3). For any 
OEM printer with Spinware and either the I/O Master board or the PA-1 board, 
select "L" (CP/M list device) and "D" (Diablo 1610/20). INSTALL will present 
no further printer-related selections. 

TETiETYPF! PRINTER 

Teletype-like (Non-Daisy) Printer: If your CP/M operating system can already 
drive the printer, specify "Teletype-like" at the printer choice menu, specif 
"None" for communications protocol, and specify "CP/M list output device" for 
printer driver. Alternately, you may wish to use the port driver for better 
keyboard response during concurrent editing and printing. 

nAT.qy wwFffT. AT ^fin RAnn 

(Serial) Daisy Wheel or Similar Printer Interfaced at 300 Baud or Less: If your 
CP/M can already drive the printer, choose the specific printer type at the 
printer menu, specify "None" for communications protocol, and specify "CP/M 
list ou^ut device" for printer driver. Or use the port driver if desired, for 
better keyboard response during concurrent editing and printing. You will want 
to change your printer to 1200 baud as soon as possible so WordStar can print 
faster. 

DATSV WHPtffT. AT ^70^ ff^pp 

(Serial) Daisy Wheel or Similar Printer Interfaced at 1200 Baud: You will need 
to use a communications protocol and a driver that can input as well as output 
characters. See Appendix D for specific discussion of your printer. Specify 
the particular printer type at the printer choice menu. Specify ETTX/ACK proto- 
col, and set the printer to match, unless unusual considerations dictate using 
a different protocol. 

PRINTER DHaSR 

For printer driver, try using the port driver. However, if your operating 
system supports multiple consoles and your printer is already accessible as one 
of the console devices, you may wish to consider using the TTY: or CRT: alter- 
nate console driver. The <3>/M list output device printer driver cannot be used 
with a communications protocol unless you patch in your own Printer Qjaracter 
Input routine (Section 7). 
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Exception: If your 1200jDaud printer is a ^3EC Spinwriter 5510/5520r you may be 
able to make a special cable instead of using a communications protocol (see 
Appendix D). If you use the special cable, you may specify "Nbne" for protocol 
and "List output device" or "Port driver" for printer driver. 

Printer Configuration 

Some printers have option switches which must be correctly set. These switches 
may be on an external control panel, on a control panel under the printer 
cover, or buried on circuit boards inside the printer. Common switches in- 
clude the following: 

APTQ L£ or LOCAL L£ (makes printer line feed upon receiving a carriage 
return code): must be OFF. 

AITTO £Sk (makes printer start a new line if an overlong line is printed): 
OFF recommended. 

2E&EQ: Must match the rate at which your computer transmits characters. 

PARiry; Set to ignore parity ("M" position on some printers). 

CommunigatiQns Protocols A "communications protocol" must be used with 
(serial) daisy wheel and similar printers interfaced at 1200 baud (120 
characters per second), as discussed above. With many printers, use of a 
communications protocol requires setting switches or adding jumpers on 
circuit boards inside the printer. See Appendix C and your printer's 
documentation. 

ESSa ISSSJS? Should be set to match paper in use if USE FORM FEEDS print 
option is to be used. 

SSL TQSLi Press after positioning paper at top of form, if OSE FORM FEEDS 
print option is to be used. 
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Installation Procedare 



THE DISTRIBUTION DISKETTE 

The diskette (or diskettes) you receive upon purchasing WordStar contain the 
following files: 

WSD.OCH Uninstalled WordStar; installation for your terminal and 

printer is achieved by running INCTALL as described in this 
section. 

WSMSGS*(77R WordStar message and overlay files; must be on diskette in 

WCNUHmOJR logged drive or drive A whenever WordStsir is in use. 

INSI!SLL«GCM WordStar installation program; used to install (custcmize) 

WordStar for your computer configuration. 

EXAMELE.HSST File of sample text demonstrating some WordStar features. 

WMIXBGEmCNR Additional overlay file for the optional MailMerge feature 
(extrar— possibly on a separate diskette). 

Creating a System Diskette 

Follow these steps to create a new system diskette to work frcm: 

1. Format a new disk. 

2. Copy a systan onto this disk. 

3. Copy PIP.GCM onto this disk. 

4. Insert this new disk into the boot drive (a:) and boot it. 

5. Insert the original distribution disk into a second drive (b:) • 

6. Copy INSEALL.COM and WSa.COM from the distribution disk (drive b:) to the 
new working disk (drive a:) using PIP. 

7. Bun INSTALL as described in detail below. INSTALL will create a new file 
called WS.COM, with WordStar set up for your particular system. 

8. Once you are certain that WordStar has been properly installed, erase 
INSTALL.COM and WSU.COM from your new working disk (drive a:) , bat not 
tram tbe distribaticn disk (dttpe bs) . 

9. Now copy all overlay files (WSMSGS.CVR, WS07LY1.0VR, and possibly the 
optional file MAILMRSEUTTB) from the distribution disk (drive b;) to your 
new working disk (drive a:) using PIP. (Tl^pe pic a2=b;*.Qvr after a>.) 

10. If you have room on your working disk, you may also want to copy SIAS.COM 
and FORMAT. COM onto it. 

11. Remove the distribution disk from drive b: and store it in a safe place* 
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Be sure to ke^ the original distribution diskette. If you wish an update in 
the futurer you may need to return it to MicroPro* 

Initiating Installation 

To initiate WordStar installation, insert the diskette containing the files 
copied from the distribution diskette, type control-C (if your system is al- 
ready up)r or else cold-start (boot) the system, and type the command: 

INSTALL 

and press RETOBN. INSTALL will take several seconds to load, after which it 
will display a sign-on message and ask its first question. At this point, the 
screen should appear as follows: 



A> INSTALL 



COPYRIGHT (C) 1981, MicroPro International Corporation 
INSTALL release x.x for MicroPro WordStar release n*n 

Do you want a normal first-time INSTALLation of WordStar? 
(7 a yes; N » display other options): I 

In response to this question, type Y« (If you type N, additional options not 
needed for initial installation as described here are displayed. These instal- 
lation options will be described in Section 5,) In response to the Y, INSC2VLL 
will tell you what it is going to do — create an installed WordStar on file 
WS.OOM, obtaining the uninstalled version from file WSO.GOM — and ask for your 
confirmation— as follows: 

This will INSTALL the WSn«COH on the current drive, save 
the result on file WS.COM on the current drive, and then 
run the INSTALLed WordStar. OK (Y/N): I 

T^e Y. (As with the previous question, an N here gets the installation 
options, which are not needed for an initial installation.) An error message 
will occur at this point if WSa.COM is not on the current (logged) drive. (If 
you need futher explanation of any error message displayed while you are 
installing your WordStar, refer to ^spendix A.) 
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SELBCTIB6 THB TERMIBAL TYPB 

A terminal choice "menu* appears next, as f ollovrs: 



MicroPro V^ordStar release n.n serial 000000 

***** WordStar TERMINAL MENU #1 ***** 

A Lear-Siegler ADM-3A C Lear-Siegler ADM-31 

D Hazeltine 1500 E Microterm ACT-IV 

P Beehive 150/Cromenco 3100 G IMSAI 710 

H Hewlett-Packard 2621 A/P I Infoton 1-100 

J Processor Tech SOL / VDM K Soroc IQ-120 

L Perkin-Elmer 550 (Bantam) 2 Terminal Menu #2 

3 Terminal Menu #3 Z None of the above 

PLEASE ENTER SELECTION (1 LETTER) : ■ 



I£ your terminal is shown on the menu, enter the corresponding letter. I£ your 
terminal is not shown, type "2" or "3" and another menu showing additional 
terminals will be displayed. 

If your terminal type is not shown on any of the menus, you must make a custcm 
terminal installation as described in Section 6. Enter Z for "Nbne of the 
above" in order to bypass the terminal menus; patch the required control 
functions (as determined by study of Section 6, i^ppendix E, and your terminal's 
technical manual) into WordStar using INSTSLL's patcher (end of this section) 
or your operating system's debugger. 

After the terminal type letter is entered, JSSrOJL will display a brief message 
confirming the terminal type and ask 

OK (Y/N): 

If you made an error or wish to change your selection, type N, and the TERMINAL 
TTPE question will be asked again. J3pon repetition, a choice U for "NO CHANGE" 
will appear on the menu. Vlbsn you answer Y to GR (Y/^ :, INSTALL will proceed 
to printer choice. You can type "B" at this or any following question to 
return to the terminal choice menu. 



PBIBTER^RELATED SELSCTIOHS 

Installing WordStar for a printer involves choosing the specific printer type, 
communications protocol, and printer driver, as discussed in Section 2. 

Selecting a Printer 

•Hie next "menu" displayed by INSTALL allows you to choose the type of printer 
which the installed WordStar will drive: 
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***** PRINTER MENU ***** 
(More specific info is displayed after choice is entered) 

A Any "Teletype-like" printer (ie almost any printer) 

C "Teletype-like" printer that can BACKSPACE 

D DIABLO 1610/1620 daisy wheel printer 

E DIABLO 1640/1650 daisy wheel printer 

P QUME Sprint 5 daisy wheel printer 

G NEC Spinwriter 5520/5520 thimble printer 

I "Half -Line-Peed" Printers 

M I/O MASTER / O.E.M Printer combination 

U no change 

Z none of the above 

PLEASE ENTER SELECTION (1 LETTER) : I 



If your printer is listed, enter the appropriate letter. If you don't see your 
printer r type A, (or C if you know your printer can backspace). See Section 2 
and Appendix D for futher discussion of the printer choices* INSIS^LL will then 
displ£^ a message explaining any special considerations relating the printer 
selectionr then ask 

OK (Y/N) : 

If you wish to change your selection, type N, and the PRINTER menu question 
will be redisplayed. To proceed to the next mam, t^pe Y. Also, you may type 
B to return to the beginning of the dialogue. ISie space bar may then be hit to 
keep the prior answer to questions whose answer you do not wish to change. 

The M selection on the above menu applies to all brands of "OEM" daisy wheel 
and similar printers (NEC 5500D, Qume Sprint 5, Diablo Hy-Oiype 11) when inter- 
faced with the MicroPro "I/O Master" board. For further discussion of these 
printers in combination with the "VO Master" interface see Section 2, as well 
as the message displayed when M is entered. Since no communications protocol 
nor driver selection is necessary when installing WordStar to use an "OEM" 
printer with the 1/0 Master" interface, the next two menus are skipped when M 
is selected. 

If you chose M at the printer menu (above) , proceed to the next subsection 
("Bypassing the Patcher") 

Selecting a Communications Protocol 

The next menu displ^ed permits choosing a "communications protocol", as dis- 
cussed in Section 2. 
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***** CX5MMDNICATI0NS PROTOCOL MENU ***** 

A "Communication Protocol" is necessary with some printers 
to prevent printer buffer overflow and character loss. 

E EXT/ACK Protocol 

X "X-ON/X-OPP" Protocol 

N NONE required (or handled outside of WordStar) 

D no change 

PLEASE ENTER SELECTION (E, X, Nr B^ or U) : I 



As noted in Section 2, the appropriate answer is usually "None" except for 
daisy wheel and similar printers interfaced at 1200 baud (120 characters per 
second) , for which the appropriate choice is usually "ETX/ACK". Enter the 
desired letter. INSTALL will then display a message confirming the selectionr 
th&ci ask CR (Y/N): as for the preceding menus. 

Selecting a Printer Driver 

The final printer-related menu permits choosing a printer driver: 



***** DRIVER MENU ***** 

Or, how should WordStar send characters to your printer? 

L CP/M "List" device 

P Direct I/O to 8-bit port 

S User-installed driver subroutines 

U no change 

PLEASE ENTER SELECTION (L, ?, Sr Br OR U) : ■ 



If "none" was specified for "^Communications protocol"r then XS/VL list output 
device" is commonly the appropriate choice here. See Section 2 for further 
discussion. Enter the desired letter. INSTALL will display a confirming 
message and ask CR (Y/N): as after previous selections. 

Port Driver 

If you selected a printer driver other than P at the above menu, or if you 
entered H at the printer menur proceed to the next subsection ("Bypassing the 
Patcher") . 

If you selected WordStar's port driver (P on the above menu)r INSTSLL will ask 
additional questions to determine how to access your printer (see Section 4). 
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BYPASSING THE PATCHER 

A£ter the printer selections have been completed r INSTALL will display the 
prciupL: 

ABE THE MCDIFICAnONS TO WORDSTAR NC^ GCMPLETEE? 
IF TEE? ABE ANSWER YES TO TSE NE2CT QOESTICN. 
IF YCU WISH TO MAKE ADDITI(^3AL PATCHES TO THE 
USER AREAS IN WQBDSEAR ANSWER NO TO TEE NEXT QDESTICN. 

OK (Y/N): 

For a normal installationr type Y. If you type Nr the "patcher" will be 
activated. The patcher permits additional custom modifications r not usually 
needed when WordStar is first installed. Description of the patcher will be 
deferred to the end of this section. 

Note * 

In the subsections that follow, you will learn how to repeat the 
installation dialog and how to re-INSTALL a previously INSTALLed 
WordStar (using the installation options). In either case, you can 
retain the previous selection by pressing the space bar (or BEIUBN) 
at the Printer Driver Menu. If the previous selection was F and you 
press the space bar, the additional questions for the port driver 
will not be reasked; the old answers will be kept. If you wish the 
port driver questions to be reasked, so that you may change one or 
more answers, type P at the Printer Driver M^iu. 

CONFIRMING OR CORRECTING TOUR SELECTIONS 

All of the installation choices have now been presented. INSTALL will next 
display the terminal type, printer type, communications protocol, and printer 
driver that you have selected, then ask OK (Y/N): yet once more. If you wish 
to make any changes, type N or B, and INSIALL will return to the Terminal Menu, 
allowing you to repeat all of the selections. For those choices you do not 
wish to change, enter a space. INSIALL will keqp the previous selection. 

When everything is as you wish it, type a Y at this final confirmation. 
INSTALL will then automatically save the installed WordStar on a file named 
WS.COM, for future use, then start (pass control to) the installed WordStar, 
allowing immediate use. 

The next two subsections describe the installation options and the patcher (not 
normally needed for initial installation). The various error messages that can 
occur during INSTALL are given in ^:pendix A. 

INSTALLATION OPTIONS 

As described above, the INSTALI^rogram normally takes an uninstalled WordStar 
from file WSD.COM on the current drive, creates an installed WordStar on file 
WSXOM on the current drive, then executes the installed WordStar. 
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Occasions may arise when you wish to vary the above procedure. You might wish 
to use different file names, or files on drives other than the current drive 
for the final installed copy of WordStar or you might wish to start with a 
previously installed WordStar in order to change one of the selections without 
reentering them all. 

WSXRLL has provisions for operator entry of the file names to be used, and for 
return to the operating system instead of starting the installed WordStar. To 
use these optionsr invoke INSTRLLr then type N at first question "Do you want 
a no rmal first-time installation?". INSTALL will then display the INSTALLATICN 
OFnCNS menu as follows: 



***** WordStar INSTALLATION OPTIONS MENU ***** 

A INSTALLation of a distributed WordStar, INSTALLing WSU.COM, 
producing WS.COM, and then running the INSTALLed WordStar. 

B INSTALLation or re-INSTALLation of a WordStar COM file of 
your choice, placing the newly INSTALLed WordStar in a file 
of your choice, and then exiting to the operating system. 

C Same as B except run the INSTALLed WordStar. 

D Modification of the INSTALLation of a WordStar COM file of 
your choice. The modified WordStar replaces the original 
file. The modified WordStar is then run. 

PLEASE ENTER SELECTION (A, B, C, or D) : I 



Ordinary Install and Run 
(Installation Option A) 

Selection A on the Installation Options menu corresponds to the normal case. 
The dialog then proceeds as described above, as though you had entered Y to 
the question "do you want a normal firstHiime installation?". 

Install to Another Pile and Exit 
(Installation Option B) 

Selection B asks for two file names as follows: 

Filename of WordStar to be INSTALLed? ■ 

At this question, type in the name of the file from which INSTALL is to 
take the WordStar to be "customized" for your terminal and/or printer. 
Normally, this is file WSU.COM; you might want to enter "B:WSU" to get 
waJXOM from drive B when the currently logged drive is A; or, you might 
want to enter the file name of a previously installed WordStar (e.g., 
"WS") in order to change some of the installation selections without 
re-entering all of them. 
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T^inq errors in the file name may be corrected by backspacing with con- 
trol-H or riiboutJ Control-U may be used to erase the entire answer. 
Terminate your answer with the RETUHN key. I£ you omit the period and 
file type, INSTALL will assume .COM. (If you press RETUBN without 
entering anything, WSSKLL will assume WSUXOM). 

If the file you specified was not found, INSTALL will respond 

THAT PILE DOES NOT EXIST 

and repeat the question. Note that you must include the drive name 
(letter followed by colon) at the beginning of the file name unless the 
file is on the diskette in the current logged drive. 

Filename for saving INSTALLed WordStar? ■ 

At this question, type in the file name in which you wish INSTALL to save 
the installed WordStar. '"WS" is the normal answer to this question? you 
might want to enter "B:WS" to save the WordStar on the diskette in the B: 
drive; or you may prefer a file name other than "WS". (If y ou om it the 
period and file type, INSTALL will assume XXM; if you press RETDEN with- 
out typing anything, INSTALL will write a file called "^S.COM" to the 
current drive.) 

After the two file names are accepted, the dialog under (Option B proceeds as 
described earlier in this section. After the final confirmation, INSTALL saves 
the installed WordStar on a file of the specified name and then exits to the 
operating system. Option B does not run the installed WordStar. 

Install to Another File and Run 
(Installation Option C) 

Selection C on the Installation (Dptions menu is the same as selection B — file 
names are requested as above — except that after the installed WordStar is 
saved on the disk, it is run. (Option C is thus a convenience when immediate 
use of the installed WordStar is desired. 

Modify Another File and Run 
(Installation Option D) 

Selection D on the Installation Options menu combines the two questions of 
selection B or C into a single question: one file name only is requested. 
WordStar is read from this file, customized for your terminal or printer as you 
specify during the dialog, then re-saved on a file of the same name. This 
option is a convenience when you wish to modi^ the installation of a previous- 
ly-installed WordStar — for example, to change the printer type while keeping 
the same terminal, or to change the communications protocol without changing 
anything else. 

Hhsa modifying thsL installation ot a previQusly installed WordStar under 
options ^Su.qlUj, :zsai maa t^ea JL.Sii. jaat press tha space haji at ang menu 

whose selection y^m. da not wish tg change. INSTALL will respond by displaying 
"Previous selection left unchanged: " and the previous terminal, printer, driver 
selection, communications protocol, etc, and allow you to confirm this un- 
changed selection by asking CSH (H/N): in the usual manner. 
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INSTALL 'S PATCHER 

INSEALL's patcfaer facilitates making special installations and modifications to 
WordStar. Installation of WordStar for terminals and printers not shown on 
INSCALL's menuSf and other situations in which patching might be necessary or 
desirable, are discussed in Section 6 of this manual. If you wish to make such 
a special installation or modificationf refer to Section 6, and to the listings 
in Appendices E and F, to determine exactly what patches to make. Once you 
have studied Section 6 and determined what bytes you wish to change in 
WordStar, INSTALL's patcher may be used to make the changes. 

The patcher permits examining and/or changing any byte in WSXDM. The location 
of each byte to be changed may be specified by hexadecimal address or by label 
name taken from the DSERl or USER4 listing in Appendix E or F of this manual; 
the contents of each specified byte is displayed in hexadecimal and a new value 
may be entered in hexadecimal. 

mSERLL's patcher is accessed by anwering N at the following prompt. As noted 
earlier in this section ("Bypassing the Patcher") , this prompt appears after 
the printer selections and before the final confirmation. (If you have already 
INgEATiTiPd WordStar, and wish to make patches in the installed copyr you may use 
installation option B, C, or D and press the space bar to bypass the terminal 
and printer menus without re-entering those selectionsJ 

ARE T HE M CDIFICATIOMS TO WORDSIAR ICW CTHPLETE? 
IF ISEy ARE ANSNER YES TO THE WSS QOESTICN. 
IF YOU WISH TO MAKE AEDmCNAL PATCHES TO THE 
USER AREAS IN WGBDSCAR ANSNER NO TO THE NESCT QDESTION. 

CK CY/N): 

If you type N, a summary of the patching process will be displayed on your 
terminal, followed by the prompt: 

LOCATION TO BE CHANGED: I 

Enter the desired address in hexadecimal, or enter the desired label (as shown 
in the USERl or USER4 listing in Appendix E) followed by a colon. A label may 
be followed by a "+" and a hexadecimal number to access the location that many 
bytes after the label. Examples of valid answers: 

25 B (hexadecimal address) 

CTRAIL: (label) 

CTRAIL:+2 (label plus numeric offset) 

INSCALL will tbeti display the address in hexadecimal and the present contents 
of the indicated kjyte, and prompt you for the data you wish to replace it with. 
The screen line will appear as follows: 

ADDRESS: aaaaH OLD VALUE: nnH NEW VALUE: I 

where as&, represents the hexadecimal address and nE represents the value that 
is presently occupying the byte at that memory address. Enter th e hex adecimal 
value with which you wish to be replace the old value, or press RETURN only to 
make no change. 
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You will then be prompted to enter a new location. To access the next addressr 
you may press BETORN only; to terminate patcfaingr ^iter zero (type and press 
BEZOBN). 

By using symbolic labels^ you can avoid absolute addressesr which change from 
release to release. Thus a patch made for one release of WordStar can easily be 
applied to a subsequent release without concern for changes in the location of 
the values which must be modified* 
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Seetioa 4 
Installation Procedure: 
Port Driver 

If you selected WordStar's port driver (P on the driver menu in Section 3), 
INSTALL will ask additional questions to determine how to access your printer. 

Since the installation procedure for WordStar's built-in port driver is the 
most involved installation procedure, Section 4 is devoted exclusively to this 
subject. 

I/O OR MEMOST-MAPPED 

The first of the port driver questions requires you to specify whether your 
printer is connected to "I/O ports" or "Memory Mapped Ports". Determine this 
from the technical manuals for your computer; "I/O ports" are most common. 

Are the printer porta I/O Porta or Memory Mapped (I or M): I 

Enter either I for "I/O" or M for "Memory Mapped". Entering RETURN only will 
default to "I/O" for an initial installation, or to the previous selection if 
re-installing a WordStar. 

The remaining questions determine the input and output data and status ports, 
and the status bits. If passible, find the necessary information in the 
technical manuals for your computer, and have INSTALL accept the information 
from you. However, if you cannot determine the port numbers or addresses to 
which your printer is connected or you cannot determine the status bits, 
INSTALL may be directed to attempt to determine the necessary information at 
each of the following steps. 

The determine function may not succeed in correctly identifying the information 
in all cases (INSTALL may report failure if the information is not successfully 
determined, but could report success yet produce a WordStar that could not 
print). Further, INSTALL may lock up your computer system (requiring you to 
reboot) during its attempt to determine one of the following items. Deter- 
mining the information yourself and directing INSTALL to accept the information 
from you is always preferable to having INSTALL attempt to determine the infor- 
mation. 

OUTPUT DATA PORT 



DO lOU WISH WORDSTAR TO DETERMINE THE VALDES OR SHOULD 
WORDSTAR ACCEPT THEM FROM YOU (D OR A): D 



CAUTION ••*«««•**«««•**•• 



THE FOLLOWING PROCEDURE WILL NOT WORK ON ALL HARDWARE AND 
MAT HAVE UNUSUAL RESULTS SOMETIMES. PLEASE REMOVE YOUR 
DISKS FROM THE DRIVES AND REPLACE THEM ONLY WHEN TOLD TO. 
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The next question allows you to specify whether you wish INSTALL to attempt to 
determine the output port to which your printer is connected, or you wish 
INSTALL to accept the port number or address from you: 

WHAT IS THE OUTPUT PORT FOR YOUR PRINTER? 

DO YOU WISH WORDSTAR TO DETERMINE THE VALUES OR SHOULD 
WORDSTAR ACCEPT THEM FROM YOU (D OR A): I 

IN ORDER TO USE WORDSTAR'S AID TO DETERMINE THE OUTPUT PORT 
THE PRINTER MUST BE CONNECTED AND TURNED ON, WITH PAPER FILLED. 
A PRINT WHEEL AND A RIBBON MUST BE INSTALLED; THE COVER MUST BE 
CLOSED. THE SERIAL PORT THAT THE PRINTER IS ATTACHED TO MUST 
BE SET TO THE SAME BAUD RATE AS THE PRINTER. 

On many specialty printera (NEC, DIABLO, etc.) not only do you have to have a 
ribbon in the printer, but you have to have enough to print (especially with 
the non-cycling carbon ribbons that can be used only once); otherwise, the 
printer will not be ready. 

In addition you should note that if the baud rate is wrong, the printer will 
usually print jumbled information, as well as issue odd noises; this usually 
means that the port currently showing is the correct one, but that the baud 
rate is incorrect (meaning the baud rate set at the computer doesn't match the 
baud rate set at the printer). 

Type A if you wish to enter the port number or D to have INSTALL help determine 
the port number. Pressing RETURN only will default to A. As noted above, A is 
preferable whenever you know or can find out the port number. 

If you entered A, INSTALL will ask you for the port number: 

What is the OUTPUT port number in HEX: I 

Enter the value as a hexadecimal number, or press RETURN to keep a previously 
entered value. If you are not sure of the value, consult the technical manuals 
for your computer, or try letting INSTALL determine the value for you by 
answering D at the preceding question. 

If you entered D, INSTALL will display a message prompting you to remove the 
diskette(s) from the disk drives. This is due to the fact that while testing 
ports to determine the printer output port, INSTALL may access a port used by 
the disk system. Please follow this instruction carefully. REMOVE THE 
DISKETTES, INSTALL will tell you when it is safe to re-insert them. INSTALL 
will also remind you that your printer must now be connected to the computer, 
turned on, and ready to operate. This is because INSTALL is about to try to 
print on it. 
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Next, INSTALL will start outputting characters to a port and display the 
following prompt: 

Mow OOTPDTtlng to PORT #: nn Hex OK (Y/M): 1 

where an represents the port number to which INSTALL is outputting characters. 
If your printer is idle, type M, and INSTALL will try the next port. Wait a 
few seconds and press N again if your printer is still idle. Keep pressing N 
until characters begin to print. When your printer starts printing, press I — 
the correct port number has been found. (During the process of finding the 
printer output port, characters may appear on your terminal. Disregard the 
characters and press M to try the next port.) 

OUTPUT STATUS POBT 

Next, the output status port and bits (whereby WordStar can tell when the 
printer is ready to accept another character) must be determined. INSTALL will 
again ask whether to attempt to determine the information or allow you to enter 

it: 

WHAT IS THE OUTPUT STATUS PORT FOR TOUR PRINTER? 

DO rOU WISH WORDSTAR TO DETERMINE THE VALUES OR SHOULD 
WORDSTAR ACCEPT THEM FROM YOU (D OR A): I 



Again, use A whenever you know or can determine the information. If you type 
D, INSTALL will attempt to determine the port number and bits, and will display 
the results. Any "active** status port between the bottom of port addressing 
(OOH) and the actual printer port may cause erroneous port assignment. This is 
so often the case that this "DETERMINE** function is not as useful as it might 
seem. 

If you type A, INSTALL will ask the following three questions. If in doubt 
about the correct answers, study the technical manuals for your computer or try 
typing D instead of A. 

What is the OUTPUT STATUS port number in HEZ: I 

Enter the port number in hexadecimal. 

What are the bit(s) that change at the OUTPUT STATUS port 
when the OUTPUT port becomes ready to accept a character 
for OUTPUT (enter HEX value): I 

Which bit(s) change(s) from a to a 1 (enter HEX value): I 

Enter a hexadecimal number with 1 bits in the positions corresponding 
to status bits that are 1 when the printer is ready, and bits for 
bits that must be or are insignificant. Usually, the answer to 
this question is the same as the answer to the preceding question. 
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After these prompts from INSTALL have been answered, either via the DETERMINE 
function, with data from your technical manual or with "educated guesses'*, 
INSTALL will ask you to confirm your selections by displaying the following 
prompt : 

IF lOU WISH TO RETHY THIS OPERATION ANSWER "Y" TO THE "OK Y/N" 
QUESTION BELOW. YOO MAY ABORT INSTALATION WITH A CONTROL C, 

OK (Y/N): Y 

Answering 'N» rather than 'YS as shown above, will cause INSTALL to return you 
to the beginning of the OUTPUT PORT installation sequence and you may correct 
or change any values which you feel are erroneous. 

If you chose NO communications protocol, supplying a 'Y' response to this 
confirmation question will complete installation of the port driver—proceed to 
the next subsection ("Bypassing the Patching"). If you selected a protocol, 
INSTALL will ask a series of additional questions to permit inputting from as 
well as outputting to your printer. 



INPUT DATA PORT 

The DATA INPUT PORT is the port number (or mapped address) through which 
WordStar receives characters from the printer, as required when a protocol is 
in use. This port is frequently, but not always, the same as the output data 
port. We will not take a step-by-step approach to this set of prompts since 
they are nearly identical to those outlined above for the OUTPUT PORTS. 
INSTALL again asks whether to Determine or Accept the information, then asks 
for the port number (if you typed A) or displays the results of its deter- 
mination (if you typed 0). 

Note that INSTALL will be able to determine the input port only if the 
connected printer is actually capable of and set up for the protocol selected 
for use by WordStar at the PROTOCOL MENU. 

It is possible that INSTALL will report failure when attempting to DETERMINE 
the values and bits for this operation irrespective of the correct 
configuration of your printer and WordStar. In such cases it is possible to 
force the DETERMINE function to return correct values. If your printer has a 
keyboard, try typing characters on the printer keyboard while INSTALL is 
attempting to determine the input data port. If your printer does not have a 
keyboard and you have an extra terminal or keyboard available try substituting 
this in place of the printer temporarily. Now typing something at the keyboard 
while the DETERMINE function is operating may successfuly return the required 
port number and status bits. When this operation is complete you will, of 
course, want to replace the printer on the port. 

IHFOT STATUS POST 

Finally, the input status port and bits (whereby WordStar can tell whether a 
character has been received from the printer) must be determined. Again, 
INSTALL will ask whether to attempt to determine the information or to accept 
the information from you; the dialog and reservations are similar to those 
described above for the output status port. 
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When WordStar is invoked-— either as automatically occurs at termination of 
mSTALLationr or when you type WS (or whatever file name your installed 
WordStar is saved on)— WordStar should clear the screen and display a sign-on 
showing the WordStar release and serial number and the terminal, printer, 
protocol, and printer driver choices you made at installation. 

After several seconds (or as soon as you press any key), the no-file menu plus 
the names of the files on your diskette should display, like this: 



< < < N - P 

* * Preliminary Cannands * * * 
L C33ange logged disk drive 
F Pile directory off (CN) 
H Set help level 

" * Conmands to Open a Pile * * 
D (Dpen a document file 
N Open a non-document file 



I L E MENU 
* Pile (Zommands 
P Print a file 
E Rename a file 
Copy a file 
Y Delete a file 



> > > 

*l* System (Xinmands * 
IR Run a program 
iX Exit to system 
I 

I* WordStar Options * 
IM Run Mail Merge 
IS Run SpellStar 1 



DXPECTQKY of disk A: 

GdAPna^OOC CHAFER1.BAK CEAFCR2.IXX: CSAFIR2.BAK 

C rWgM E5.I30C (XSZTEMES.EAK PILE1.IXX PILE1.CCC 

LmT£K.OOC LEri!ER.BAK TEXH^IXXZ TE2Cn.BAK 

MAII20GE.0VR WS.CCM WSMSGS.OVR WSOVLn.OVR 



aJAFl!R3.IXX 

PILE2.IXX: 

TE2CT2.IXX! 



UdAPilH3.BAK 

PILE2.BAK 

TESr2.BAK 



In the above diagram, the symbol I represents the cursor position. If 
highlighting is installed, the words displayed will be highlighted? if inverse 
video highlighting is in use, inverse video boxes will be formed around the 
menu and the phrase at the top of the screen. 



TESTING CUBSOR POSITIOHIHG 

If you get something like 



" * * * Preliminary Ocnmands * * *|* File Cannands *l*System Ccm^ 
L Change logged disk drive (now A ) I P Print a file iR Run a 



« 



mands* 

program » $ P Turii file'directory off (now OM ) I M 
to check a % H Set help level (3,2,1,0) (now 3 ) 
space on disk) » & * * Cannands to Open a File 
IX Exit to system » • d (Dpen a document file 

\M « N (Dpen a non-document file 



Run Mail Merge i (STAT 

S Run SpellStar i 

*l E R^iame a file 

I Copy a file 

I Y Delete a file I 



» + DIRECTORY of disk A: CHAPrRl.DOC CHftP33a.BAK CHAP 

TR2.D0C CHAPTR2.BAK CHAEER3.D0C CHAPnQ.BAK CQNIEMS.DOC CC NTENTS.BAK 

PILE1.C0C FILE1.D0C PILE2.D0C FILE2.BAK LEITER.DOC LETTER.BAK TEX 
T1.CCC TEXri.BAR TEXT2.DCC TEXT2.BAK MATLMRGE.OVR WS.CCM 

WSHSGS.OVR WSCVLn.OVR 

with the lines run together and random punctuation between lines, then the 
cursor positioning control codes are not working. Check your terminal documen- 
tation and the setting of all option switches on the terminal, and reinstall 
WordStar or correct your terminal as required. 
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CHECKING FOR THE MESSAGE PILE 
If you get 



editing no file 

File WSMSGS.cnm not found. Menus & 
messages will display as @@@@ only* 



then the file WSMSGS.OVR, supplied on the distribution disketter has not been 
copied to the diskette in use (or the diskette is neither in drive A nor in the 
logged drive). This file should always be on the diskette in drive A^ or the 
diskette in the logged drive (or both)^ when WordStar is in use. I^pe an X to 
exit from WordStar and return to the operating system, copy WSMSGS^OVR to 
diskette in drive A (or the logged drive) (the command PIP is used to copy 
files in most CP/M operating systems) r and invoke your installed WS again. 

TESTING THE ERASE FiraCTIOH 

Now (at the no- file menu, which should still be on the screen) type D. You 
should get: 



D editing no file 

Use this ccmmand to create a new document file, 

or to Initiate alteration of an existing docuBent file. 

A file name is 1 to 8 letters/digits r a period, 
and an optional 1-3 character type* 
File name may be preceded by disk drive letter AH) 
and colon r otherwise current logged disic is used* 

"S-delete character 'Tr^delete entry "P^File directory 
1>>restore character 'T^Bestore entry llscancel ccmmand 

NAME OF FILE TO EDIT? M 

DIRECTOPy Of disk A: 
EXAMPLE.TXT INSTALL.COM PIP.COM STAT.COM 

WS.COM WSU.COM WSOVLYl.OVR WSMSGS.OVR 



If parts of the no-file menu (what was last on the screen) appear where there 
should be blank lines r then an erase to end line code is installed but not 
working. 
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CHECKING FOR THE OVERLAY FILE 

If you get 

*** EM3ff. ERROR F46: Overlay File WSCVEXl.OTR Not Found 

then the file WSOVLyi«OVRf supplied on the distribution disketter has not been 
copied to the diskette in use (or the diskette is neither in drive A nor in the 
logged drive). Get WS0VLin.,07R onto drive A (or the logged drive), and invoke 
your installed WordStar again. 

If the above screen displays correctly, press the REIDFN key. The no-file menu 
and directory should again be displayed, with the rest of the screen clear. 

T^e D to again obtain the last screen shown. Answer the question NAME OF 
FILE TO EDIT? by typing 

TEST. DOC 

(or some other file name that is not in use on your diskette) and press RETDRI^ 
The phrase 

NEW FILE 

will be added to the screen display. After several seconds, the screen display 
should change to the following: 

A:TEST.DOC FAS 1 LINE 1 COL 1 INSERT GN 

< < < MAIM MENU > > > 

* * cursor Movement * *|* Delete *| * MisceUaneous * I * Other Menus * 
""S <±ar left 1} char right 1*^ <±ar I'H Tab '*B Refooi I (ficM Main only) 
"•A word left T word rigbtlDEL <±r If 1*^ liisert Oi or Off |'*J Help TC Block 
ns line up 'Ti line down (TT wocd rtili Flndl/Beploe againl'^ Quidc *? Print 

* * Scrolling * *|ir line IREIOBN Ehd paragraphPO Ctascreen 
-^ line up la line domi I 1*^ Insert a RETQRH I 

"C screen up 11 screen downl I'll Stop a conimand I 



TESTIH6 THE EDITIH6 FUNCTIONS 

T^pe a few words, •fliey should appear on the screen line below the "ruler" (the 
line with the -'s and I's); they should not be highlighted; the cursor should 
move right as you type. If the cursor does not move, the "column" portion of 
the cursor control codes is not functioning. 
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l^pe a "J ("J on the screen menus and in this manual means to type control-Jr 
that iSf hold down the CEFL key on your keytxsard and press J). After a second 
or twor a different menu should appear. The top line of the screenr the 
"ruler^f and the words you typedf should remain. If portions of the previous 
menu remain to the right of the new, narrower one^ then an erase to end line 
code is installed but not working. Press the space bar to return to the 
previous menu (the main menu). 

Now type several lines of text. Gibberish is OK for our present purposes. 
WordStar will "wrap" the line for you if you type beyond the R end of the ruler 
without using the PETEDBN key; this is the normal operation of word wrap. 

It should be possible to move the cursor around within the text you have 
entered, using "E to move it upr "D to move it right, "S to move it left, and 
"X to move it down. Try it. Recall that " means to hold down the CTRL key 
while typing the following letter. 

T^^pe a control-y. the line of text containing the cursor should disappear, and 
the following lines move up. This tests the "delete line" control code, if one 
is installed. Type a control-N. A blank line should appear, with the lines 
below the cursor moving down. This tests the "insert line" control code, if 
one is installed. 

ADDITIONAL TESTS FOR HIGHLIGHTIHG 

T^pe a control-K. A differait menu will appear, lype a B (or a b or "B). Itoe 
original menu will reappear, and "<B>" will appear at the cursor position. The 
<B> will be highlighted if you have Installed highlighting. The characters on 
the line to the right of the cursor will move right three characters to make 
room for the <B>. Move the cursor forward a few characters (13) or down a line 
or two CX) , and type "K twice. The menu may not change, depending how soon 
you type the second "K. 

If no highlighting is installed, <K> will appear at the cursor position. If 
high-lighting is installed, the characters from the position of the <B> to the 
posi-tion where TCK was typed should highlight - display in inverse video, or 
dimmer or brighter than the rest of the screen. The <B> should disappear. 
(What you have just done is "marked" a "block" of text, as in preparation for a 
block move or block copy command.) If the <B> disappears but the characters do 
not highlight, then inoperative highlighting control codes are installed. 

Check the codes and reinstall if necessary; if they can't be made to work, 
remove them so the <B> and <K> will display. Another possibility (if you are 
using bright/dim highlighting) is that the contrast or brightness on your 
terminal are set sudi that bright and dim characters are indistinguishable. 

Now type 'TC A new menu will appear. T^pe a D (or d or ID). The message 

SAVING PILE A:TEST.DOC 

should appear. This saves the entered text on the disk, so that you can try 
printing it. Whenever text is entered or updated with WordStar, it is neces- 
sary to save it in order to keep it permanently, or to print it. After the 
save is complete (a few seconds) , the no-file menu should reappear, as shown 
above. 
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TESTING THE PRI13TER 

To test the printer installation, type a P at the no-file menu. Worc3Star will 
ask you for the name of the file to print; enter TEST.JXX: or whatever you 
called the file. Press the PLUUKN key. Several more questions will be asked; 
just press REIUHN at each one for now. When Ready printer, press RE^TOBN 
appears, make sure your printer is turned on and on-line (whatever your 
particular printer needs to be ready for use), then press any key. The text 
you entered should be printed, then the paper should feed to the bottan of the 
page and a "1" (page number 1) should be printed. 

You may now delete (erase) the test file you entered, by typing a Y and 
answering the question UAME OP PILE TO DELETE? by entering TESTJXDC (or 
whatever you called your file) and pressing PEIDBN. 

To return to the operating system, type an X at the no-file menu. The system 
prompt A> will appear at the bottan of the screen. 
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Custom Terminal Installation 

MODIFICATION BY PATCHING 

General Description 

Modification by patching is used in installing WordStar for terminals not 
included in the installation menus (Section 3) and for printers that require 
special control strings or modifications to one of WordStar's printer drivers r 
and for achieving refinements in installationr such as supporting special 
features of specific non-daisy printers^ circumventing the "DELEEH-backspace 
feature" of certain operating systemsr or enabling display in the last column 
of the last line of the screei. 

Since basic installation is achieved with the INSTALL program as described in 
Sections 2-5, most users should not need to patch. 

"Patching" means modifying WordStar by changing the contents of bytes in 
WS.QOM. Patching may be accomplished with INSEALL's patcher (as described in 
Section 3) or with your debugger (DOT in most systems) or with your computer's 
front panel switches. Sections 6,7, and 8 of this manual are primarily for 
those who already understand patching. 

Tiffrt-ings in i^ppendix 

Appendices E and F contain absolute assembly listings of two user-patchable 
portions of WordStar, USEPl and aSER4: 

o nSERl is the module containing all term ined.- installation related 
patdi areas; 

o USER4 contains all printer-related patch items for non-daisy 
printers, plus many used for both daisy and non-daisy printers. 

The listings are commented heavily; read them for a detailed description of 
each item. !Ihe following paragraphs give general description of the modules, 
and hit a few high points of the details, but do not attempt to duplicate the 
detailed information contained in the program comments. Note that the 
addresses provided in these listings are correct for the revision of WordStar 
specified on the listing and not necessarily for any other. Where LABELS: can 
be used, independence from revision-dependent locations is provided and is 
therefore desirable. 



mJlFYim TOE TERKDRL IBSRS AREA 

Modification of the terminal patch area is used for these purposes: 

o to In stall WordStar for a terminal or video board not provided for in the 
INSTALL program 

o to achieve a different installation for a terminal that is on the menu 
(e.g., to reverse the sense of bright/dim highlighting to suit Individual 
preference) 
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o to achieve refinements in installationr sudi as permitting display in the 
last character position of the last line of the' screei or disabling seme 
operating systems' backspace-on- rubout "feature" that interferes with 
WordStar's screen updating 

o to drive a terminal device which is not accessible via the operating 
^stem* 

Installation for a Terminal 
Nbt Sbown on Terminal Mienu 

WordStar can be installed for most terminals by determining the terminal's 
control codes as discussed in this sectionr then making patches as discussed 
later in this section ('*rerminal Patch Area"). Ohusual installationsr such as 
direct storage access to a video board, or use of a terminal which cannot be 
accessed via the operating system, are described in the next subsection ("Video 
Boards and Custon Terminal Drivers") • 

TERMINar. REQPTREMENTS AND OPTTONS 

To be used with WordStar, the terminal must have a screen at least 16 (and not 
more than 120) lines high by at least 40 columns wide, and have the caipability 
to place the cursor at any position on the screen upon receipt of a suitable 
control sequence from the computer. 

Desirable, but not essential, additional terminal features include line insert, 
line delete, and/or erase to end line — these may speed screen redisplay 
during editing — and inverse video, bright/dim, or some other form of charac- 
ter-by^-character highlighting — highlighting allows WordStar to differentiate 
the menus and questions from the text of the document being edited, and to 
highlight the "marked block" of text that is to be moved or deleted.. 

DBrmmiNS ccwrocii gcbes 

The first step in installing WordStar for a terminal not on the menu is to 
study the terminal manufacturer's manual to determine the screen size and the 
control codes which WordStar must transmit to the terminal to accomplish the 
various functions. Additional discussion of each required and optional 
function follows; patching the codes into WordStar is covered later in this 
section ("Terminal Batch Area") . 

QlRSOR-POSmCINTyE CnyfPRQL CODES 

Positioning the cursor is the most complex terminal function used by WordStar, 
since it involves transmitting the row and column at which the cursor is to be 
placed. The form of the control string sent to the terminal to position the 
cursor varies widely from terminal to terminal; WordStar's cursor-positioning 
patch items are designed to accommodate almost all commonly used forms. For 
these reasons, it is necessary to analyze your terminal's cursor-positioning 
sequence to derive the information needed to patch WordStar. 

Some terminals have a single control sequence to position the cursor at a line 
(row) and column (character) number; others have separate control sequences to 
position the cursor on a line and at a column; either will work with WordStar. 
In the former case, the terminal may require either the row or column trans- 
mitted first. For some terminals, the line and column numbers are sent with no 
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offset, that iSr a zero is sent for the top line on the screen (or left 
column) r a one for the next line dovm (next column over), etc For others r an 
"offset" is added. 

For example r several terminals require 20 (hexadecimal) for the top line or 
left column, 21 for the second line (or column), etc. For most terminals, the 
row and column are sent in binary, with a single byte (character) transmitted 
for each; for a few terminals, the row and column are each sent as a two- or 
three-digit ASCII number, with a character (ASCII "0" through "9") transmitted 
for each digit. 

Analyze the cursor positioning codes for your terminal, as described in the 
terminal manufacturer's manual, and dstermine: 

1. Number of characters and character values that must be sent before 
either the line or column is transmitted. 

2. Whether the row or column is tranaaitted first. 

3. Number of diaracters and character values that must be sent after the 
row (or column, whichever is sent first), and before the other 
dimension is sent. For many terminals, this is no characters. 

4. Number and values of characters to send after both row and column, it 
any— usually none. 

5. Offset to add to row number — usually zero or 20 hex. 

6. Qtfset to add to column number — usually same as for row. 

7. Whether row and column are sent as single-byte binary value (the 
usual case) , or multi-character ASCII number. If ASCII, determine 
the number of digits— ususally two or three. 

Qirsor Control Qvte Escample A 

Terminal requires, in order, IB hex, 3D hex, line number plus 20 hex, column 
number plus 20 hex, to set cursor position. The answers to the above questions 
are as follows: 

1. 2, IB, 3D 

2. Row Is first 

3. Nbne 

4. None 

5. 20 hex 

6. 20 hex 

7. Binary 

Cursor Control Code Sxamplft B 

Terminal requires IB hex, 01 hex, line number to set cursor to line, and IB 
hex, 02 hex, column number to set cursor to column. The above questions may be 
answered as follows: 
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1. 2, iBr 01 

2. Row Is first 

3. 2, iBr 02 
4* None* 

5. 

6. 

7. Binary 

Cursor Contcol Code Example C 

To position cursor, terminal requires, in order, IB hex, 43 hex, column as 3- 
character ASCII nuint)er (with leading zeroes), row as 3-character ASCII number. 
The answers to the atove questions are: 

1, 2, IB, 43 

2. column is first 
3« None 

4* None 

5. 

6. 

7. 3-digit ASai 

The answers to the above questions provide the information necessary to patch 
WordStar for your terminal's cursor positioning control codes; application of 
this information is covered later in this section ("Tfermjjial Patch Area"), 

If you have an extremly unusual terminal, you may find that it is not possible 
to analyze its required cursor positioning commands into answers to the above 
seven questions. For such cases, you must write (or have a programmer write) a 
subroutine to generate the necessary cursor positioning command sequence; 
installation of this subroutine is covered below ("Terminal Batch Area"). 

ffrrrffTiTfTyfnac (cpnoMaii 

We also recommend determining the codes to invoke highli^ting, if available, 
by inverse video display, bright/dim display, or some other method. If both 
bright/dim and character-by-character inverse video are available, we suggest 
inverse video, as it will highlight blanks as well as other characters, and 
sta n ds out strongly. The highlighting method must operate on a charaeterHay- 
character basis, take no screen positions, and not be tied to field protection. 

Determine the code or code sequence to turn highlighting on, and the sequence 
to turn highlighting off. The "Highlighting on" sequence should cause 
subsequently transmitted characters to be highlighted until a "Highlighting 
off" sequence is transmitted. WordStar always turns highlighting a£f before 
transmitting a carriage return, line feed, or cursor positioning sequence; 
therefore, it does not matter whether or not these functions cancel high- 
lighting on your terminal. 

ERASE TO END OF LTOE fOPTICMAL) 

This function blanks all character positions from the cursor position to the 
end of the current screen line. 
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nCT.P!TR T.TVTR (nffrrntm.) 

This function should delete the entire screen line containing the cursor/ 
moving the following screen lines up one line. 

IMSSKT LINE (QPTICMLL 

This function should insert a blank line on the screen at the line containing 
the cursor, moving the cursor line and following lines down one line. If your 
terminal inserts below the cursor line- put a "cursor up" code at the beginning 

i2£..fcha "Insert line" string patched into Wordstar. 

After determining your terminal's control codes, proceed to "Terminal Patch 
Area" later in this section. 

Video Boards and Custon Teniiiial Drivers 

WordStar normally accesses the terminal by inputting and outputting characters 
via the operating system (direct jumps to the "BIOS" entry points are used) . 
However, two variations are also supported: direct storage into a memory-mapped 
video board for output, and custom user-supplied subroutines for input, status, 
and/or output. These variations are of interest only to users with unusual 
installation requirements; most readers may skip directly to '"terminal Batch 
Area" later in this section. 

DTPBCT STORACS TO A VTDEQ BnARD 

A memory mapped video board accessible (including cursor positioning) through 
the operating system character output calls may be installed as any other 
terminal is installed; you may proceed as described in this section ("Installar- 
tion for a Terminal Not Shown on Terminal Menu" and ''Terminal Patch Area"). 

However, WordStar can access memory-mapped video display boards meeting certain 
restrictions by storing directly into the video memory area. Such direct 
storage results in superior performance: extremely fast screen update, use of 
all character positions including last column of last line, and line insertion, 
line deletion, and erase to end line without the need of control codes for 
these ftmctions. Further, direct-storage access to a video board makes about 
2K more memory available for the file being edited. 

The memory-mapped video board requirements for direct-storage access are as 
follows: 

o Each character position must appear as a location in memory, contigit- 
ously from a starting address. The first line must begin at the 
starting ad^ess, the second line must immediately follow the first, 
etc The lines must always be full length; WordStar will blank-fill 
them as required. 

o Highlighting, if used, must be invoked by setting the high order bit 
of each character to be highlighted. WordStar cannot invoke high- 
lighting in any other manner while storing directly into a video 
board. 

Whei accessing a memory-mapped video board on a direct storage basis, WordStar 
can position the cursor either with the control code sequence or user-installed 
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subroutine (as for a terminal) , or by setting the high order bit in memory of 
the character under the cursor. Highlighting can be produced by setting the 
high order bit; this produces inverse video on many boards. If the high order 
bit is used both for highlighting and for cursor display^ WordStar can blink 
the cursor to make it stand out when it is on or adjacent to highlighted text. 

Even i£ cursor displsY is by bi^t-order bit, a cursor position code segoenoe or 
subroutine should be installed, as ViordStar uses it to position the cursor at 
the bottom of the screen at exit, and to initially get its cursor and the 

externally known cursor in the same place. 

To Install WordStar to access a memory-mapped video board meeting the restric- 
tions described above on a direct-storage basis r patch locations MEMAPV, 
MEMADR, HIBIV, HIBCURf and CRBLIV as explained in the associated comments. 
Note that the cursor positioning items as used for a terminal should always be 
patched even if HIBCDR is non-zero. Note also that there is a page of comments 
near the end ot the listing giving installation suggestions for video boards 
which do not meet the requirements for direct-storage access and which cannot 
conveniently be accessed via the operating system. Use items SWIN and SWODT if 
it is necessary to switch the board into the address space before access and 
switch it out after access. 

For video boards that are not always addressabler WordStar can switch the board 
into the address space before storing into it and switch it out after each 
accesSf provided the board occupies addresses above about 8000 hex when 
"switched in". 

Custcm installation for direct-storage access to a memory^mapped video board is 
accomplished by patching; proceed to '^Terminal Batch Area." 

QJgrCM ODNgOLE DRIVER ^mOfl'lNF^ 

Custom subroutines may be installed by the user tor console input, console 
status (character ready), an^/or console output. SUch routines may be used to 
access a terminal device not accessible through the operating system and which 
is not a memory^mapped video board meeting the requirements given above for 
direct-storage access. For example, a memory-mapped video board with non- 
contiguous lines or variable-length lines (disallowing direct-storage access) 
and no cursor positioning control codes (disallowing access through the operar 
ting system) might be driven via a custom console output subroutine which could 
interpret control codes as required. TUne patch locations and calling sequences 
for these routines are given in the USERl listing in i^pendix E, as discussed 
below ( "Terminal Patch Area") . 

TEFMIML PAaXS AREA 

All patch Items relating to terminal I/O and terminal control codes are in 
program module USERl, as listed in Appendix E. Many are set by the INSTALL 
program (thusr INSTBLL should be run before, not after, patching, if you patch 
with DDT). Additional items can be changed only by patching. Each item is 
identified and explained in detail by comments in the listing; the following 
discussion corresponds approximately to the order of items in the listing. 

Note that all character strings to be sent to the terminal (erase to end line, 
etc.) have the number of characters to be sent in the first byte, and the 
characters to send in following bytes. 
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ISsEminal Installation 

An earlier subsection ("Installation for a Terminal Not Shown on Terminal 
Menu") discussed requirements and information to be obtained from the terminal 
manufacturer's manual before making a custan terminal installation; read that 
section first if you have not already read it. The locations into which to 
patch terminal-related items are clearly identified by comments in the USERl 
listing. The first two items in the listing are the locations into which to 
patch the screen height and width; following these are locations for cursor 
control string specification as analyzed per the seven questions given earlier 
in this section. 

Ihere is provision (item COFOS) for cursor positioning by an alternate method, 
calling a subroutine written and "patched in" by the user. The calling 
sequence for this subroutine is detailed in the comments; the information the 
subroutine receives includes the row, column, number of character positions 
from beginning of screen to cursor position, and number of character positions 
from beginning of screen to beginning of screen line containing cursor. 

Space for the optional erase to end line, delete line, insert line, 
highlighting on, and highlighting off strings is given. Spaces for strings to 
be sent to the terminal at startup and at exit are provided, to allow special 
initialization or mode selection and deselection; there are cdso provisions for 
user-supplied subroutines which are called at startup and at exit. 

Displaying in the Last Column 
of the Last Line dOSELSSi 

A flag, USELST, is provided in USERl which may be patched non-zero to enable 
display in the rightmost column of the last line of the screen, making the 
"flag" character for this line display. 

WordStar does not normally display in the rightmost column of the last line of 
the screen (except when using direct memory access to a video board), because 
many terminals autanatically carriage return after display in the last column 
of a line, scrolling the screen up a line if it was the line at the bottom of 
the screen. For some terminals, scrolling after display in the last character 
position on the screen can be disabled via an option switch (possibly called 
"AOTO BETDHir) inside the terminal; for others, such scrolling can be disabled 
via a mode selected with a control character string sent from the computer. 

If you have a terminal which does not scroll after display in the last 
character position, or has been configured thus, patch USELST in USERl (see 
listing in Appendix for address) nonr-zero to see the "flag" on the last file 
line displayed. If a mode which does not scroll after display in the last 
character position can be selected by a control sequence sent from the 
conputer, the initialization string TRMINI may be used; the exit string 1EM0NI 
may th&i be used to restore i^e normal mode for convenience when using other 
programs after exiting from WordStar. Notes it doesn't matter where j±ie CUrSQg 
goes— nowherer ql J2a£ii ^ "home"— after displaying in th& last character gcsi- 
ticHf SSL Ism. as, J±e screai dc?es wL scroll iiq ^ line* 
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Batcfaable FQnction Delays (DELOIS and DELMIS) 

Patchable function delays, DELCDS and DELMISf are provided for use after the 
terminal functions indicated in the listing. These are pres^it because many 
terminals lose characters if character output occurs too soon after cursor 
positioning or other functions. The default values are sufficient for most 
terminals; INSTALL increases and decreases them as necessary for certain 
terminals on the menu. For custom installations , you may need to patdi longer 
or shorter delays as explained in the comments. 

Usually it is best to get these delays to work before implemoiting any of the 
"unnecessary functions" (functions other than ABSCLCTE CDRSDR BOSITIONING and 
SO^EN HEIGHT and WIETH). Get the terminal to work reliably (meaning charac- 
ter s don't disappear and meaningless characters don't appear) by increasing 
the DELAXS. Start by varying DELMf AFTER CDRSOR SET (DELCDS:). Try increments 
of 10 hex bytes until the terminal steps being erratic. This will get all the 
spurious characters problems about 80 per cent of the time. Those problems 
left over can usually be "fine-tuned" away by varying DELMIS: using the same 
approach outlined for DELQJS:. 

Oice the "grossest" gross values for DELMIS: and DELCDS: ha^e been determonedr 
reduce DELCDS: until the problems just start to reappear. Ifext raise this 
delay 6 or 7 increments. Do the same thing for DELMIS:. 

Next, install the highlighting functions (if available). • This can often 
require that the DELAYS (either one or both) be increased several times the 
value required without highlighting them. Sometimes the terminal becomes so 
slow before highlighting will work properly that the user will have to decide 
whether or not highlighting is worthwhile. 

Finally install ERASE-TOEND-OF-UNEr INSERiy-LINE and DELETB-LINE FDNCTICN& 
Tbese are supposed to speed things up. Sometimes they do and sometimes they 
slow things down (i.e., DELCDS and/or DELMIS have to be increased to get the 
display acceptable when any one or combination of these functions are 
installed) . 

As a rule of thumb, use only those which speed up operation. If any one of the 
special functions slows things down, do not install it (them) and let the 
software do that function instead. 

If any of these functions or combination of these functions resulted in a 
significant increase (10 or more decrements of DELMIS:, 20 or more decrements 
of DELOJS:), it may be time to try the HIGHLIGHTING FDNCTICNS again (assuming 
they slowed things down and they were left outg in the previous step). Some- 
times, when these functions actually do speed things up they can have a pro- 
found ^f ect on the operation of the HIGHLIGHTING functions. 

Note that "sufficient" may mean acceptable to the general user, but tweaking 
for maximum performance is the American way and is more often than not possible 
and effective. 



6-8 



Section 6 Custom Terminal Installation 



d rcumwM ting the System's 
DBLBIB-BacfcsEaoe ^^tnre" 

When a command is being entered to the operating system and the DELEIB (HMJlfiO 
key is used to erase the last character entered, standard CF/M echoes the 
character erased. A number of manufacturer's and distributors variants of CP/M 
1.4 have a modification added in the I/O patch section of the system ("BIOS") 
to cause the DELETE key to erase the character on the screen instead of echo 
another copy of the daracter erased. This modification works by ou^utting 
"backspace, space, backspace" in place of the next character output after a 
DEI£TE is input. 

While a convenience in entering normal system commands, this feature interfe res 
with WordStar operation: the next character output by WordStar after a DELBZE 
is input is normally the beginning of a cursor positioning sequence, and if it 
is not transmitted without modification, the results on the screen are disas- 
trous. Hence, there are provisions in USERl for disabling the DELEIS-backspace 
"feature". 

If your operating system erases c±aracters on the screen, rather than echoing 
characters, when you use the DELEIE key while inputting a system ccmmand, AND 
if the screen line containing the cursor is not correctly updated whsi you use 
the nETJJTF! key while editing with WordStar, or the cursor is misplaced after 
use of the DELETE key, then your system has the DELESS-backspace "feature" and 
this "feature" must be disabled for correct screen updating in WbrdStar. 

Examine the code of the BIOS (I/O patch) section of your system (listings of 
this portion of the systan are normally supplied, or available on request, or 
you may poke around with your debugger without a listing) to determine how your 
DELETE backspace "feature" works, and apply one of the following methods to 
disable it. 

Zeroed After OBracter Inwt (ZfiFCIN) 

Many DELETE-backspace implementations set a flag when a DELETE is input, or 
just store the last character jiiput, in a fixed memory location, thai substi- 
tute "backspace, space, backspace" for the next character output after a DELETE 
is input. Such implementations can be disabled when WordStar is running by 
patching the address of this location into USERl at ZAFCIN: if ZAFCIN is non- 
zero, the location it points to is Zeroed AFter Character IHtgut by WordStar. 
For example, S. D. Sales and Digital Microsystems' versions of CP/M, among 
others, store the last character input in location 4F hex. I^tdiing ZAFCIN to 
4F prevents the DELETE-backspace feature in these systsns from interfering with 
WordStar's screen updating after the DELETE key is used. 

Butoit ^ix Locations 
fSDBETg and RFEffiR) 

These USERl locations may effect a partial fix to the DELETB-backspace problem 
in cases where ZAFCIN cannot be effectively applied. If RDBFXF (RDBout Fix 
Flag) is patched non-zero, thai the contents of PFIXER is output immediately 
after a DELETE is input. Put a relatively harmless character in HPIXER - try 
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null (00 hex), backspace (08 hex), or space (20 hex). When this character is 
output, your system will replace it with "backspace, space, backspace"; this 
will have less deleterious effect than changing the beginning of a subsequent 
cursor positioning string to Ibackspace, space, backspace** Ihe results will 
probably be a single blanked screen position, instead of an entire messed up 
line and a misplaced cursor. 

CbstcB Cc3ns6Ie Driver Routines 

Items UQISEA, UOONI, and DCONO allow installation of custom terminal I/O rou- 
tines to be used in lieu of calls to the operating system's "BIOS" entry 
points. 

To facilitate special video board installation, the custom terminal output 
routine (UCONO, as detailed in the listing comments) receives the following 
information: character to be displayed (with high order bit on for hic^ighting 
if HIBI7 is patched non-zero), row, column, number of character positions from 
beginning of screen to cursor position, and number of character positions from 
beginning of screen to beginning of screen line containing cursor. 

Note that the custom teminal character input routine (UCONI) nay be called 
whether or not the status routine (UCNSTA) has already indicated that a 
character is available, despite a coament to the contrary in a prior release 
USEBl listing. Thus, your UOONI routine must include code to wait if necessary 
for a keystroke. 

Delays 

Items DELI through DEL4 allow control over the delay times used within WordStar 
to blink the cursor, hold the sign-on on the screen, etc You may wish to vary 
these to accomodate your QD speed or to suit your preference. 

Note 

Near tiie top of page 15 (Appendix E) are three special flags, TSiSCBSf 
TRSCIF, and HETHBS. These do nothing in normal WordStar; they are 
active only in special versions, and are appropriately set by the 
WSnUi program supplied with those versions. 

Batch %aoe for Added Stisrootjiies 

Items nC3?P0S, INISDB, UNISDB, and others allow for a user-added subroutine; 
however, space is provided at these items for a JMP instruction only. Ihere is 
space for a considerable amount of code at MOHPAT, on the last page of the 
nSEBl listing. If more space is needed, go to the free memory area, as pointed 
to by the actual contents (examine with UDSH of VEOHEti at the end of USEPl. If 
you make additions there, be sure to patch PBGMEM to point beyond your addi- 
tions, and be sure to determine and use the necessary SAVE command size — note 
that there are several thousand bytes between the normal eid of the .CXDM file 
and address contained in FBGMEM. 

Patches in this area must be made with your debugger (DDT); INSEALL's patcher 
will not correctly make patches in this area. Also, if you operate on your 
WordStar with the INSOSLL program after adding code at the ^d, you will need 
to redo your additions — INSTRLL will delete any code beyond the normal end of 
WordStar. 
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Ttesting Year TfrrminaT installation 

Iteview Section 5 (^Testing WordStar"). ISiat section ^ows various correct and 
incorrect screen displaySf and gives likely causes of the incorrect displays. 
The tests given there will help you determine whether your installation is 
functioning correctlyr andr if not, which patch item is most likely at fault. 
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Section 7 
Custom Printer Installation 

Modifications in the printer patrh area are used to support optional printer 
features, to install unusual printers which are similar to, but not exactly, 
"Teletype-like", and to support communications protocols including specif- 
ication of EOV^CK message length* Modifications in the printer patch area are 
also used to handle unusual installation requirements with regard to the 
transmission of characters from (as required by communications protocols. 
Section 2) and to the printer. 

This manual do es no t cover patching to support the features of daisy^ wheel 
printers. Ihe TSSTNIt program performs complete installation to support all 
available features of the common daisy wheel and similar printers (including 
NEC 5500-series, Diablo, and Qume printers). Patching for such printers is 
extremely complex due to the interaction of many features and the requirements 
of bidirectional printing, variable character width, and variable line height. 
By purchasing Cnstoaization Notes, you can proceed with such patching. 
However, all aspects of transmission of characters to and from serial daisy 
wheel and similar printers are accessible and documented in this section. 

The assembly listing of module USEB4 in i^ippendix F shows all modifiable items 
relating to Teletype-like and other non-daisy printers, and all modifiable 
items relating to transmission of <±aracters to and from Teletype-like printers 
and serial daisy wheel and similar printers. 

The rest of this section will follow the approximate order of items in the 
nSER4 listing, to facilitate relation of the text to the listing. Users making 
an installation requiring a communications protocol (Section 2) will probably 
be first interested in the printer driver patch items; these are described 
later in tiiis section ("Printer Drivers"). 

PSISrER TSPB m SELAITED TSaSS 

Printer OTeistxite Method (POSmB) 

POSMTH determines how overprinting, as required for boldface, double strike, 
underline, backspace, etc. is acheived. 

If POSMTH contains FP hex (as set by INSTSLL when "Any Teletype-Like Printer" 
is selected) , WordStar will overprint by sending a carriage return code (see 
item PSCR) followed by another complete line, containing spaces in columns not 
to be overprinted. Several overprint lines for the same document line will be 
sent if necessitated by the use of multiple enhancements or boldface. 

If POSMTH contains zero (as set by INSERLL when "Teletype-like Printer That Can 
Backspace" is selected), WordStar will overprint by backspacing (see item 
HACKS in the next subsection) then sending the character to be overstxuck as 
each character position requiring multiple strikes is encountered. FOSM3Bs0 
produces faster printing than POSMTEs^T for printers that can backspace; also, 
P0SMT&4 will allow printing underline, boldface, backspace, etc on printers 
that can backspace but cannot return the carriage without line feeding. 
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If any daisy wheel or simdLlar printer is selected in IBSTALLr FOSMTH will be 
set to 1 and should not be altered. 

Bold-Strike (EE£6IR) 

ELD6TR contains the number of strikes of each character used for the Ixsldface" 
print enhancement* For Teletype-like printers, it may be increased or de- 
creased to yield darker or lighter boldface; for daisy wheel and similar 
printers it should not be altered. 

Double-Strike (IBLSXR) 

DBLSTR contains the number of strikes (normally 2) used for the "double strike" 
print enhancement; it may be increased for darker "double strike" or reduced to 
1 for no double strike, on any printer type. 

HUKCER FCJNCnCN SISJN3S 

Fatchable strings for a number of mandatory and optional printer functions are 
provided. Each string consists of the number of characters, followed by the 
character values. When altering a string, make sure you set the number of 
characters correctly. The optional string items should have a zero "number of 
characters" if the c|>tional function is not installed. 

ikivaooe to the liext Line (PSGRCf*-* 
Print String; Carriage Betonir line Feed) 

This is the character string, normally "carriage return, line feed," sent to 
advance a non-daisy printer to the beginning of the next line. The characters 
in the string may be altered as required by unusual printers; the count may be 
increased to send nulls (zeroes) (up to a total of 10 characters) after the 
character string is sent if the printer requires a delay while the carriage 
returns and the paper advances. 

Hetirn i to the Start of the Saaoe Line 
(PSCfr— Print String; Carriage Betam) 

This is the character string, normally carriage return only, used to return the 
carriage of a nonrdaisy printer to the beginning of the same line. This string 
is used to permit overprinting for underline, boldface, etc. if POSMTH (above) 
is FP hex; it is also used whenever a carriage return without a line feed is 
encountered in the document, if POSMTH is PP or (see "^^yerprint Lines" in the 
Reference Manual). 

HonH3aiay Radcs^ace (PBilCKS) 

This is the character string, normally an ASCII "backspace" character, used to 
backspace a non-daisy printer. This string is transmitted if POSMTH (above) is 
zero in order to permit printing a character in the same position as the 
preceding character for underline, boldface, backspace, etc Note that if 
POSMTH is not zero this string is never transmitted and thus the printer need 
not be capable of backspacing. 
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BbiHDBtS7 Tfti fH'ilne Advance 
(I5EiaLF--qotdLooaD 

This is a character string to return the carriage and advance the paper one- 
half linef f cr non-daisy printers with this capability but without tiie capabi- 
lity o£ advancing the paper backwards a fractional line (see also RQLOP and 
ROLDOW below). If installedr the half-line advance will be used to print 
subscripts and superscripts one-half line below or above/ respectively, the 
rest of the line. 

Example: If the printer advances one-half line for each line feed code sent, 
install the sequence "carriage return, line feed" at PSHALF and the sequence 
"carriage return, line feed, line feed" or "carriage return, line feed, 
carriage return, line feed" at PSCPLF. 

Note 

The INSTALL Printer Menu selection "Half-Line-Feed Printers" sets 
PSHMiP and PSCELF to the foregoing strings; this selection is other- 
wise identical to the selection "Teletype-Like Printer that can 
BACKSPACE". 

Non-0ais7 BoU UP (IICLO^-(^)tLaiial) 

This is a character string to roll the carriage UP (move the paper down) a 
fractiohed line, for non-daisy printers with this capability. If RQLDP and 
RCLDCW are installed, subscripts and superscripts will be printed by moving the 
carriage up and down in the course of printing a line. 

liDn-0ais7 Boll Dowi (BCEiDOW-qptiaBl) 

If ROLOP (preceding) is installed, then the string to roll the carriage down 
(paper up) a fractional line should be installed at PGLDGW. 

Non-Oadsy Mtemate Pitdi (B9CP— qptiomD 

A string may be installed here to set the printer to an alternate character 
pitch (character width), for non-daisy printers with this capability. An 
alternate pitch print control (^A; Reference Manual) in the documeit will then 
invoke transmission of this string. 

Note 

WordStar contains the necessary logic to restore normal pitch while 
printing page offsets, headings, etc. that were specified when normal 
pitch was in effect. 

Non-Daisy Standlard Pitcb (PSID— Cptiaaaa) 

If PALT (preceding) is installed, then the string to restore the printer to its 
normal character pitch should be installed at PSTa 

Special Ftmctions (DSRl tiicoogh USB4— G^tional} 

These strings may be installed to invoke otherwise unsupported special 
functions of your printer (e.g, changing character fonts or activating a ^eet 
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feeder) in response to the User Printer Function print control characters CQ, 
'^Wr ''E, and '*Rr Reference Hanaal) imbedded in your document* For character 
pitch changes f PALT and PSTD should be used in preference to USPl through USR4. 
If you have a daisy pr inter r USRl through USR4 control strings should be 
installed with great caution^ and tested thoroughly, as complex interactions 
with WordStar's operation of the printer are likely to occur despite the fact 
that WordStar always prints forward when printing a line containing a user 
printer function control. For seme printersr INSTESLL may define one or more of 
these controls; check ^pendix D with regard to your printer. 

Non-Daisy Ribbon Color 
(RIEBCN and RIBCFP-qptional) 

These strings may be installed by the user to allow selection of alternate 
ribbon color with the '^Y print control (Reference MannaD on non-daisy printers 
with this capability; for daisy wheel and similar printerSr RIBBON and RIBQFF 
are set appropriately ty INSERLL. 

Non-Daisy liiitilization String 
(PSIl!irT--qptLonaI) 

This is a string transmitted to the printer at the start of printing. For non- 
daisy printers, you may add any desired controls, (e.g., to turn the motor on 
or select a line spacing or character pitch) • INSCSLL puts a carriage return 
in this item; add your bytes and increase the count appropriately. For daisy 
printers, this item is dp^opr lately set by INS!EBLL and should not be altered. 

Nbn-Daisy Finish String 
(X5FXHI— <]|)tionaD 

Similar to PSBJIT, this string is sent at the conclusion of printing. 

Initialization and Finish SbbEOotines 
HOHITand PBFIHI— GltiionaD 

These are subroutines called at the beginning and end of printing, respective- 
ly; they may be used to perform printer assignment or special initializati o n 
functions that cannot be performed by trananitting a character string, ^ce 
is provided for a JMP only; for finding space to put your subroutine, see 
"Tterminal Patch Area," Section 6. 

PRJUIER IBJ^JEBS 
Printer Driver Flags 

PRINIER DRIVER £L^ (CSWTCa) 

Value determines which of the printer drivers (see next subsection) is used to 
transmit characters to (and possibly from) the printer: 

0: CP/M "List CXitput" Device 

1: WordStar's Port Driver 

2: User-installed Printer Driver Subroutines 

3; OEM Daisy Wheel and Similar Printer Driver 

4: Alternate Console Printer Driver 
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CSWTCH applies to all printers* CSWTCH is set by INSTALL in accordance with 
the choice made at the "Printer Driver" menu. 

Printer Busy 'Tgst Flag fHAVBSy) 

HAVBS7 should be set to 

o non-zero if the printer driver in use has a "printer busy test" 
implemented 

o zero if no provision has been installed for determining when the 
printer is reac^ to accept a character. 

When non-zerOf WordStar will not output to the printer until the printer is 
readyr and WordStar will check more often whether the printer is ready to 
accept a character. !IhuSf a correctly Installed printer busy test, plus a non- 
zero value in HAVBSY, cause the printer to run more steadily when editing is 
being performed at the same time as printing, while improving keyboard response 
in editing because the printer output routine will never "hang" while waiting 
for the printer to be ready to accept a character. 

naanVLL sets HAVBSY non-zero if the port driver is selected, or zero if anotiier 
driver is selected. The user should set HAVBSY non-zero after adding a busy 
test to the CP/M list device driver or the alterrate console driver, or after 
installing custcm driver subroutines that include a printer busy test. 

Code for four distinct printer drivers is provided in USER4, and thus 
accessible to user modification. Location CSWTCB, described above, determines 
which driver is called. 

Dr jbper EkiLiy Points 

As discussed in Section 2, WordStar must be able to input from 1±e printer as 
well as output to the printer when a Communications protocol" (as required for 
daisy wheel and similar printers at 1200 baud) is in use. Also, WordStar's 
performance improves when a "printer busy test" is available to determine 
whether the printer is reacty to accept an output character. Thus, each driver 
has three ^itry points, defined as follows: 

Printer Busy Ttest* This entry should return the carry flag set (1) if the 
printer is NOT ready to accept a character; the carry flag should be 
returned clear (0) if the printer is ready to accept a character or if 
the busy test is not implemented. If this entry is implemented, HAVBSY 
(above) should be non-zero; if not implemented, HAVBSY should be 0. 

Print charactg>r » This entry should output the character in the A register 
to the printer. If HAVBSY is non-zero, this entry is not called until 
the printer busy test entry returns the carry flag clear. 

Input Character Prom Printer s This entry need be implemented only if a 
communications protocol (Section 2) requiring input from the printer is to 
be used. This entry should return the carry flag set (1) if no character 
has been received from the printer since last called, or return the charac- 
ter in the A register and the carry flag clear (0) if a character has been 
received. 

^5ecif ic descriptions of the printer drivers follow. 
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CP/M List Device Driyer 

The "print character" entry point to this driver is implemented to make the 
appropriate operating system call to print the character. Hie "printer bu^ 
and "input character from printer" entries are not implemented, as standard 
CP/M provides no system calls for these purposes; space is provided at LIBSY 
and LISINP respectively for patching in JMP instructions to user- installed 
subroutines for these purposes. For finding space into which to patch added 
subroutinesr see the end of the subsection on "Printer Driver Flags" earlier in 
this section. 

If you add a "printer busy test" routine, patch HAVBSY to a non-zero value. 

If you use a communications protocol with the List output driver, you must code 
and patch in an "Input character from printer" routine, and put a JMP to it at 
LISINP. 

WordStar's Port Driver 

The "Port driver" does direct hardware I/O to any printer interface using at 
most one output data port, one output status port, one input data port, and one 
input status port. The ports may be I/O ports or memory-mapped ports. The 
port driver includes implemented printer busy test and printer character input 
routines. When the port driver is selected during installation, the INSEHLL 
program will accept the port numbers and status bits from the operator, or, on 
request, try to find them experimentally as detailed in "Port Driver" under 
"Printer-Pelated Selections." 

The port driver code is in nSER4, and thus accessible for further modification 
if desired. Note tha t the port driver as shown in the nSEP4 listing access 1/0 
ports with "IN" and "^OCT" instructions, but that a NOP is present after each to 
allow substitution of "LDA" and "STA" instructions for memory-mapped I/O. 
ISSnSLL makes this substitution if memory-mapped I/O is specified. 

Alteznate Console winter Driver 

The alternate console driver will drive a printer interfaced to be one of the 
four physical console devices (TT!?:, CRT:, BAT:, and DCl:) other than the 
terminal, under operating systems which support multiple console devices and 
device assignment via ICBYEE (location 3? see your operating system documenta- 
tion). The alternate console driver supports character input from the printer, 
making it convenient for use with communications protocols (as required for 
daisy wheel printers interfaced at 1200 baud); the alternate console driver 
does not include a printer busy test unless added by the user at location ACBSY 
(if you add a busy test, be sure to patch HAVBSy non-zero). 

Ihe alternate console driver entries work by changing ICBYTE, doing the console 
input or output, then restoring lOBYTE. The lOBYTE console field value used 
for printer access is taken from location CONPIE. CONFIE is set to by the 
INSEMiL program when the THi printer driver is selected, or to 1 when the CRT: 
console driver is selected. One of the other two console devices may be 
accessed by patching CONPIE to 2 or 3. 
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OBer-Sdpplled Printer Driver Sdbroofciiies 

Space is provided at PUSEND, PDBSYr and PDINP for patching in JMPs to user- 
coded and user- installed printer character output, printer busy test, and 
printer character input routines. For finding space into which to patch your 
routines, see the end of ""Kenninal Patch ^eas," Section 6; also, you may patch 
over the other drivers if you do not expect to use them at a later date. Nbte 
that the printer character input routine is mandatory if a communications 
protocol is installed; otherwise, this routine is not needed. Also patch 
HAVBSY non-zero if the busy test entry is implemented, or zero if it is not 
iirplemented. 

CSWTCH must be set to 2 to cause WordStar to call the user- installed printer 
driver subroutines; this patch may be achieved by selecting "User subroutines" 
in USfSJlNIi before patching in your routines. 

OEM Daisy Printer Driver 

The OEM printer driver is pre-conf igured to drive certain "^EM" daisy printers 
through the MicroPro "I/O Master" interface addressed at ports F8-PA hex, as 
detailed in Appendix D and Section 2. Modification of this driver should not 
normally be necessary; the OEM driver is not included in the aSER4 listing in 
Appendix F. 

INSTALL sets CSWITCH to 3 to invoke the OEM daisy printer driver when "I/O 
Master Interface / (XEJH Printer Combination" is selected at the Printer Menu. 

OQwmniCBsnzss xsaDOGOLs 

A communications protocol (Section 2) is normally used with a (serial) daisy 
wheel or similar printer interfaced at 1200 baud; in these cases, the canmuni- 
cations protocol items are correctly set by the IN5XSLL program. However, the 
communications protocol logic will function wii± any printer (except an OEM 
daisy printer, for which it is not pertinent). For an unusual Teletype-like 
printer that requires a protocol, you may wish to patch these items. 

Protocol Type (IBOTCL) 

ERQTCL determines type of communications protocol. The types of protocols are 
defined in the program comments and also in Section 2: 



None 

ETX/ACK (and see EAKBSZ, next) 

XOVi/XOFF 



PROTCL is set by INSTALL in accordance with the selection made at the 
'^Communications Protocol" menu. 
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EIX/?CR Message Length 
(ESBBBSZ— fi!DI^DCZ Buffer Size) 

Eil^RBSZ contains the message length for Fnx/MX protocol; it must be equal to or 
less than ONE-fli^iP OF the printer's buffer size, as WordStar keeps two "mes- 
sages" active at a time. ^Qie default value (127) assumes the printer can hold 
a buffer of at least 254 bytes; be sure to reduce it if you install ETX/ACK 
protocol for a non-daisy printer with a smaller buffer, When a daisy wheel or 
similar printer is installed with EOSS/ACK protocolr INSTALL autcanatically sets 
EfiKBSZ for the buffer capacity of the particular printer selected. 
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OTHER PATCH ITEMS 

In addition to the previously described patch items relating to terminal and 
printer installation, WordStar can be patched for a number of additional items, 
including the following: 

Command keys, including prefix relationships and keystroke synonyms 

All texts — menus, error messages, question prompts, etc, 

initial values for help level and insert toggle 

Initial values for all on-screen formatting options 

Default page format 

Flag characters (rightmost screen column) 

Serial diasy wheel and similar printer function strings 

OEM daisy printer driver 

Complete listings of the patch areas for these items, along with discussions, 
are contained in a separate publication, the WordStar CuatPmization HPteg> If 
you are interested in obtaining a copy of that publication, contact MicroPro 
mtemational Corporation* 

Descriptions of a few additional patch items of particular interest follow. 
The items are identified here by label only; the items may be patched (and/or 
their current hexadecimal addresses obtained) by using INSTALL' s patcher as 
described in Section 3. Further discussion of these and many other items, plus 
pertinent listings, are included in the WordStar OlFltOTnirrflt.ion Ifetes> 

Tnitial Help Level (USELE) 

Change this byte to 0, 1, 2, or 3 as desired to set the "Help Level" in effect 
when WordStar is invoked. 

Help Level Message (NnBLF) 

Setting this byte to enables display of the message 

For maxiinim help (full menu display) , 
select Help Level 3 by typing "JH3. 
This message will clear when a key is pressed. 

at the start of the first edit if help lev el is 1 or 2. Setting this byte to 
FF suppresses the above message. Use if I'ltiHI.P (previous item) is changed to 
2 and some users will be new WordStar users to whom level 3 would be helpful. 
Use FF if ITHELP is 3, so the above message will not appear if the user types 
H2 at the no file menu before initiating an edit. 
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Initial msert Toggle CHITOG} 

Change this byte to to make WordStar come up with insertion OFF, FF hex to 
come up with insertion ON. 

Tnitial No-File Menu Directocy 
Dt^OaY Toggle OXDSDR) 

Set to FF hex to come up with directory display ON; to to come up with 
directory display OFF. 

Jtistificaticn Toggle (INIIHE!±D 

Set this byte to to come up with justification OFF (ragged right); set to FF 
hex to come up with ji^stif ication CN. 

Hsppbenrfielp Toggle (INIIflE!!^ 

Set this byte to to come up with "Hyphen-help" OFF; FF hex to come up with 
"Hyphen-help" ON. 

Decimal Point Cbaracter (DBCC2R) 

This byte is normally 2£ hex to designate a period as the decimal point in 
decimal tabs; European users might wish to change to 2C hex (comma). 

Hypbenation Pauses (HZCRB} 

Decrease for more h^enation pauses (i.e., to hyphenate shorter words) under 
^ with Hyphen-'help on; increase for fewer such pauses. Normal value is about 
4. 

FooB Feeds CFGCBCJ^iD 

Default for the Print and MailMerge USE FORM FEEDS question: make FF hex to 
use form feeds unless operator ej^licitly enters a "no" response. 

Quit Page Nunbers (IIPC3EN) 

Default omit-page-numbers flag: patch nonrzero for implied "U3P" at beginning 
of each f ile, i.e., to omit page number at bottom of each printed or Merge- 
printed page unless and until JEN dot command is encountered in document. 

Variable Name Delimiters 
(VABCHl and V»BCH2) 

Delimiter characters used before and after variable names where the variable 
value is to be inserted in a document being MailMerged. VARCHl is the charac- 
ter used before the variable name; VABCH2 is the character after the variable 
name. Both are normally "&". They may be changed if desired; if changed, 
they may be the same or different. 

Data File Field DpI imi ti*r CR7SJM) 

Delimiter character used between fields in a data file being read by Mail- 
Merge. Normally 2C hex (comma). 
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Tn4<-^ai Default to N Mode QODOC) 

Patch to QETB to enable default entry to non'-document mode CN) after response 
to the pranptr "FILEKftME.TYP. " 

Aotonatic Backspace Owracte^ 
CSJSXJES through AOT0B&f9) 

Up to 10 "autobackspace" characters may be defined by entering their ASCII 
codes at AUTOBS and following locations. Whenever one of these characters is 
typed during text entry, WordStar will automatically enter a backspace print 
control CE) into the file after the character. This feature reduces the 
number of keystrokes required to enter text containing accent marksr in cases 
where the accent marks are separate characters on the printer. For example, if 
you patch 60 hex (the ASCII code for V**) at AUTOBSr then whenever V" is 
pressed during text entry, ".^" and a control-H are entered into the file, 
making it possible to enter "a" with the keystrokes ,\ a only. 



PATGHIKG WORDSTAR'S PRINTER DRIVER 
FOR CERTAIN TERMINALS 

Altos 



1. 
2. 
3. 
4. 
5. 
6. 
7. 



FUNCTION 



MASK ALL EOT BUSY BITS (ANI) 



MAKE BITS CNE IF BEM3I (XOR) 



OOTPDT POPT (DATA) 



INPOT PORT (DPHA) 



MASK FOR CHAR FPM PTR READy 



MAKE BITS (3ffi FOR CHAR READ? 



STATDS PQPT 







ADDRESS 1 

• 


1 VALDE II 


II 2.10 


2.25 


.93A 


1.01 1 


1 HE3C II 


II 72C 


72C 


5E8 


618 1 


1 04 II 


II 72E 


72E 


SEA 


61A 1 


1 04 II 


II 734 


734 


5F0 


620 1 


1 IE II 


II 741 


741 


NUSD 


62D 1 


1 IE 11 


II 73B 


73B 


5F6 


627 1 


1 01 II 


II 73D 


73D 


5F8 


629 i 


1 01 II 


II 729 
II 738 


729 
738 


606 


615 1 
624 1 


1 IF II 
1 IF II 



INSTALLAnC3N NOTES: Uses port designated as printer port in ALTOS 

documentation. 

NDSD » NOT USED IN THIS VERSICN 
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Dynabyte 



1. 
2. 
3. 
4. 
5. 
6, 
7. 

8. 



FUNCTION 



MASK ALL BUT BUSY BnS (ANI) 



MAKE BITS CNE IF READY (XDR) 



OUTPUT PORT (DATA) 



INPUT PORT (DATA) 



MASK FOR CHAR FRM PTR READY 



MAKE BITS CNE FOR CHAR READY 



STATUS PORT 



ZERO THESE ID DATA INPUT & 
ODTEOT PORTS ARE NOT SAME 
(not relevant to RELElASE's 
1.00 and latex) 



1 1 ADERESS 1 1 VALUE I | 


1 1 2.10 1 2,25 1 .93A I 1,01 I I HEX I | 


II 72C I 72C 1 5E8 I 618 1 I 10 1 1 


1 1 72E I 72E 1 5EA 1 61A 1 1 10 I I 


II 734 1 734 1 5F0 I 620 M 86 II 


II 741 1 741 1 NUSD I 62D M 80 I | 


II 73B 1 73B 1 5F6 I 627 I I 08 II 


II 73D 1 73D 1 5F8 I 629 1 1 08 1 1 


11 729 1 729 1 606 1 615 II 83 || 
11 738 1 738 1 1 624 1 i 83 II 


1 1 UNSD 1 UNSD I 5FB I UNSD II 00 I I 
1 I UNSD I UNSD i 5FC I UNSD i | 00 1 1 
1 1 UNSD j UNSD 1 5FD I UNSD i I 00 II 
1 1 UNSD 1 UNSD j 5FE j UNSD It 00 I | 

I i UNSD 1 UNSD 1 5FF I UNSD i I 00 II 

II UNSD I UNSD I 560 I UNSD I I 00 1 1 



NOTES: 04-28-80 - 



It will be necessary to connect pins 4,6,8, and 
20 at the printer side of the cable to each 
other. The pins at the con^uter side can be 
left unconnected. Ihis will provide that all 
handshaking is done via software (this means 
you mast use ETX/ACK protocol) • 

UNSD = NOT USED IN IHIS VERSION 
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Vector Graphics 



(I 
II- 
II- 
I- 



lititegiua 



II 
-11- 



NZRESS 



II VSUIB 

•I 



1. 1 1 MftSK ALL BDT BDSY BITS (ANI) 

I 

2. I I MAKE BITS ONE IF READY (XDR) 

I 

3. I I ODTPOT PORT (DATA) 



4. 
5. 
6. 
7. 



INPDT PORT (DA13V) 



MASK FOR CHAR FPM PER READY 



MAKE BITS ONE FOR OBAR READY 



STATOS roRT 



II 
II- 

II 

1 1 


2.1 


1 2.25 

1 


729 


1 729 

1 


1 1 

II 

t 1 


72C 


1 72C 

j 


1 i 

II 

1 1 


734 


1 734 

1 


1 1 

II 

1 1 


741 


1 741 

1 


1 i 

11 

1 1 


73B 


1 73B 
1 


1 1 

II 

1 t 


73D 


1 73D 

1 


'\ 1 

II 
11 
-11 


729 
738 


1 729 
1 738 
1 



618 



620 



62D 



627 



627 



615 
624 



BEL 



01 



01 



06 



06 



02 



02 



07 
07 



NOTES: 04-28-80 - You will very likely have some difficulty 

bringing 1M3K1)STAR up on a VECTOR GRAPHICS MZ 
but this has nothing to do with the printer 
, patch. See the document "NOTES ON ODNPIGORING 
WORDSTRR FOR THE VECTOR GRAIHICS MZ"# available 
from MICROPRO. 

UNSD » NOT USED IN OHIS VERSION 
NR a NOT RBQDIRED 



ViDBD633VR FOR MP/M 

A WordStar which is targeted for use under MP/H should be installed to take 
advantage of certain MP/M-specif ic functions and/or avoid certain CP/M-specif ic 
conditions. 

TCXPLGs The use of the MP/M system clock for determining certain timinq 
functions within WordStar will significantly improve performance when more than 
one WordStar is running under the same MP/M system. Changing TOKFLG: from 00 
to FFH will cause WordStar to utilize the MP/M clock rather than its own 
isolated 16-millisecond timing loop. 

RSTFL6: Due to the presence of a number of USERS on a single system and to the 
nature of multi-operating systems in general, the normal disk "remounting" or 
RESET function is often a nuisance- This reset function can be suppressed for 
operation in MP/M environments by patching the flag RSTFLG: to FFH. 
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NMOFaS: NMOFUS+l: The number of users on the system is set to 1» but can be 
patched to handle up to 255, Resetting will increase throughput of WordStsu: 
under MP/M (or on a console-^rivenr interrupt-driven computer) r and will cause 
WordStar not to poll CSTAT as often- Be sure to set NMOPUS+l:«NMOPnS: for 
initial response* 

DEFDSK: Due to the possible confiqurations of the multiple user files, it is 
sometimes desirable to redefine the disk (read USER) to which WordStar will 
automatically go to find the overlay files. This can be done by placing 
the suitable drive number in DEFDSK: where A: is OlH. B: is 02Hf etc. 
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ilppendiz A 

TWffTWJi Error Messages 

ddLs appendix proirides explanations of the messages that can be displaced while 
you are running INSEALL (Section 3) • 

NOT ERDOGH MEMQR7 TO WS W3SPSLL, 
ORKXm QPERATINS SZSTEM IS NOT 
RQOIS^aSD TO HAKE ALL PAM AVAILABLE. 

This message will occur when msniLL is invoked if your computer system 
contains insufficient memory. AlsOf this message will occur even when 
sufficient memory is present in the computer but your operating system 
(CP/M or equivalent) has not been "relocated" to make the K\M available. 
Sudi relocation is accomplished with a system command sometimes called 
tPM"r "MO^CPM", or "RELOC" — see your system documentation for details. 

NOT OaCD GH MEMDRg TO BDN WordStaTf 
GR "KXIR QFEBATING SSSSEH IS NOT 
B£LOCATED TO MAKE ALL RAH AVAILABLE. 

Ihis variation of the preceding message will occur when the memory avai- 
lable is sufficient to run INSTALLr but not enough to run WordStar. If 
you get this message, you can still produce an installed WordStar on a 
diskette file (for use after more memory has been made available on the 
system f or for use on a different system) by re-> invoking INSTALL and 
specifying Installation Option B. This error message can occur only on 
normal installation and on those cptions which run the installed WordStar 
after installation has been completed. See Section 1 for WordStar's BAM 
memory requirement. 

WSQ.OCM NOT FOOID ON CDRBEZir DISK 

This message occurs during "normal" installationf or under Installation 
elation A ("Installation Optionsr" Section 3) if the uninstalled WordStar 
(file WSU.COM) is not found on the logged drive. For example, if WSD.COM 
is not on the diskette in any drive, or if the current drive is A: but 
file WSD.COM is on the diskette in drive B. Copy WSD.COM onto the dis- 
kette in use, or use installation option B or C to read it from the 
diskette in another drive. 

THAT PILE DOES NOT ESdST 

Tills message does not occur during 'formal" installation. Dnder Installa- 
tion C^)tion B, C, or D, this message indicates that no file was found with 
the name you entered for the WordStar to be installed. This message 
usually indicates that the name was mistyped, the drive was omitted, or 
the desired diskette was not in the drive. After displaying the message, 
IR9CALL asks for the file name again, allowing you to enter the corrected 
name or allowing you to reenter the name after inserting the correct 
diskette. 
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HCQRRECQUr FOEMED FILENAMB 

Uhder Installation C^ons Br Qt and Dr this message indicates that a file 
nane entered was not a correctly formed CP/M file name as (tescribed in the 
Reference Mannal . After displaying this message^ INSESLL will repeat the 
file name question. Qiter the corrected f ilename« 

DNEXFBCTED END OF FILE DCIRIN5 BEAD 

•Hie file from which the uninstalled WordStar was being read was shorter 
than expected, OJiis message may indicate that you are using a bad copy of 
WSD,O0M — try getting a fresh copy from your distribution diskette. If 
you entered the file name under Installation Option Br C, or D ("Installar- 
tion Optionsr" Section 3) , this message may indicate that the file you 
named was not a WordStar. 

DISK FULL 

DISKETTE DIRECTOR? POLL 

The disketter or its file di rectory r has filled up while attempting to 
record the installed WordStar. After this message, the WS.COM (or other 
file being written under Installation Option Br Cr or D) will not be 
valid. Arrange more diskette space (e.g.r by copying some files off onto 
another diskette), then repeat installation. 

ERROR aOSBG FILE 

This message should not occur; it indicates a system failure, or that yoa 
changed diskettes while INSTALL was recording the installed WordStar. 

This version of INSTALL is incanpatible with the 
version of WordStar you are trying to install 

This message can occur on using one release of INSTALL with a different 
release of WSO,C0Mr or with a previously installed WordStar cf a differait 
release. Use INSTALL and WSU from the same distribution diskette to- 
gether. This message may also occur if the file from which the uninstal- 
led WordStar is being taken (WSU.COM, or name entered by operator under 
Installation Option B, C, or D) does not actually contain a WordStar. 

^e INSTALL sign-on message, showing the release number, and the WordStar 
sign-on message, showing its release number, are displayed on the screen 
below this error message. 
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3i& IigbHs. II Keyboard 

Hie PfKple II lacks some keys found on most terminals. In particular, there is 
no provision for generating lower case or a number of special d^aoqacters. If 
the "software U/L case conversion" option was selected diaring installation, 
then WordStar will provide for generation of lower case, as well as ^ full 
ASCII character set* 

The ^SC l^ey is used by the to>le II for the shift lock/unlock f unction. In 
addition it the SHIFT key moditication is not installed then IST^so doubles 
as the shift key. In this case, press ESC twice for shift lock and once for 
regular shift. Note that the ESC key is also used for WordStar functions. 
Whenever you press ESC for a WordStar function, an additional press or two 
will be needed to return to the proper upper/lower case mode. (A little 
experimentation here can be helpful.) 

The LEFT ARROW key, which was previously a backspace (CTRL H), has been 
translated to give the RUBOOT code. This allows LEFT ARR0V7 to be used to 
delete a character to the left of the cursor. If the SHITT key modification 
has been made the FORWARD ARROW key can move the cursor to the right without 
altering the text under it. 

The nine ASCII characters not usually available from the ^pple II Keyboard are 
software generated in the locJH mode. 



WordStar has adapted the ^I^m 1^^ function lusing the ESC k^'"^' inscribed 




exclamation point wh«<^6«ii hold l^e*^ mT^"k^ dow^ and press JU However, when 
you are in ^Mp2la JLsik aP^e^ ycm will see a vertical' 3^%^ iii^tead on the 
screen. The same priiK|ipl@"^'-^lies^ in^ -t^ tollowiiag case^r- ^ ^ ."^ 



"1" Eicl^pati??'^ 'Woint^ (I) • Vertical .f4Jr^^ CD 

"7" Closing single guote (') ^^ling single .quote C*)"^ 

■=" B3u%^#:i4^};~ -" "^iderlip0.^^ 

■?" Que^^iofs, ferk (?) - ^ .Backslash (\) 

"8" l^%rmtm^MsiB {{) ^ ' '' 'Left Braoe_({) 

"9" Rig^ Mrenthesi^ ()) k'ght Brace 0) « 

■," LefeA4i:^l@-Ecacket «) ^ Left^Ognare Bracket CD 

"•■ Rigb|:t l^gle Bradket C>) tight- ^liare Bracket' (J) 

"M" cap^A "M'^.|M>f :? .Tii42 ri ''" '' 

* Cannot be displi^^ ^ the SUp'R'Termi j&i Will s-^i^' a^'^oe ii^stead. 
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Appendix B 
WordStar Versions for 
Specific Compater Systems 

Most computer systems use the standard version of WordStar, as docianented in 
the rest of this manual* Special versions of WordStar are distributed for a 
few specific systems which require a highly specialized adaptation of 
WordStar* This appendix describes the differences of these special versions 
from the standard version* 

If your system is not shown in this appendix, then it uses the standard ver* 
sion* The standard version is adapted to your terminal and printer using the 
INSEBLL program, as described in Sections 2-4* 

HEATH 89 VERSION 

The "Heath 89 Version" is intended to run on Heath 89 and Zenith 89 computers 
which have EOM in the first 16K. This version is origined at 4300 Hex (rather 
than the usual 100 Hex) and has the terminal pre- installed* 

Note 

An "A" appended to the release number (e*g., "2*25A") indicates the 
4300 hex origin* 

(For Heatii and Zenith 89 computers which have been modified to accept programs 
origined at 100 Hex, the regular version of WordStar is used* Select "Qeath or 
Zenith 89" as terminal when INSTWiTiIng*) 

Since the terminal is pre-installed, a file called "WS*GOM" is supplied on the 
distribution diskette in place of the usual "Wsn*O0H"* 

C^n receiving your Heath 89 WordStar, do the following: 

1* Format a blank diskette with the FOBMAT program and place a CF/M 
system image on the diskette using the SY5GEN program* 

2* Use FILECOPY to copy WS.COM, WSMSGS.OVR, WS0VLn.07R and INSrALL.COM 
from the distribution diskette to the newly formatted diskette. 

The edit function may now be used, as the Heath 89 WordStar is supplied with 
the terminal pre- installed* To select a specific printer (or a different 
terminal, if you have an external terminal connected to your Heativ^Zenith 89), 
use the INSTALL program (Section 3). Because of the limited capacity of a 
HeatVzenith 89 diskette, it is necessary to write the newly installed WordStar 
back onto the same file. We suggest the following steps: 

3* Invoke WSSNL by typing INSTALL and pressing RETCRN (Section 3)* 

4* Press N to get to the installation options menu* 

5* Press D to select installation option D ("Installation Options," 
Section 3). Enter the filename W&COH* 
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6* Tbe space bar may be used to bypass the terminal menu. 

?• Make the desired printer selections ("Printer-Related Selectionsr" 
Section 3), and complete INSlSLLation in the usual manner ("Bypassing 
the Eatcher" and ''Confirming or Correcting Your Selectionsr" Section 
3). 

TRS-80 MODEL I VERSION 
Installation 

Upon receiving your TRS-80 Model I WordStarr do the following: 

1« Format a blank diskette with the FORMAT program and place a CP/M 
system image on the diskette using the SYSGEN program* 

2. Use PIP to copy WS.COMr WSMSGS.OVR, WSOVLn^OVR and INSrALL.COM from 
the distribution diskette to the newly formatted diskette. 

The edit function may now be used, as TRS-80 Model I WordStar is supplied with 
the terminal pre- installed- To select a specific printer (or a different 
terminal, if you have an external terminal connected to your TOS-80), use the 
INSIBLL program (Section 3). Due to the limited capacity of a TRS-80 diskette, 
it is necessary (in a single drive system) to write the newly installed 
WordStar back onto the same file. We suggest the following steps: 

3. Invoke WSTPUm by typing INSJNJL and pressing RETURN (Section 3). 

4« Press N to get to the installation options menu. 

5. Press D to select installation option D ("Installation Optionsr" 
Section 3). Ehter the filename WS.COM. 

6« The space bar may be used to bypass the terminal menu* 

7. Make the desired printer selections ("Printer-Related Selections," 
Section 3), and complete INSTALLation in the usual manner ("Bypassing 
the Patcher" and "Confirming or Correcting Your Selections," Section 
3). 

TRS-80 Keyboard 

The TRS-80 Model I lacks a number of keys present on normal terminals. The 
following keys on the TRS-80 keyboard are used to perform the indicated 
functions in WordStar; 
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B 




Regular key 


1SS-80 key 


cnsi 




DOWN ABBO^ 


RETIDBN 




ENTER 


ESCAPE 




Hold DGKN ARPCB7, 
press UP ABRCW 
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Camnents 



DELETEf PDBOOT EBE^ 

"H or "S LEFT ARROW, '^^ or ''S 

TBB or "1 RIGHr ARBCW or *I 

(alpha lock) CISAR 



To enter a control character r 
hold DOWN ARROW and press 
desired letter. 



Delete character left of cursor 

Backspace cursor 

Advance to next tab step 

Set keyboard for upper case 
letters only. Press again for 
lower case. 



APPLE II VERSION 

Sjystai Rpqni rciMcntD 

Welcome to WordStarl To be able to run WordStar on an Apple II ccmputerr 
you nust have the following: 

o A 48K or 64K Apple II computer (64K is not necessary, but is hi^^y 
recanmended— use either the language card or a 16R RAM card) 

o A Microsoft Z-80 soft card 

o An 80-column video board (either the Videx VideoTerm or the M&R 
sup' R' Terminal) 

o Cde of the following systens: 

DOS 3^ (for tiie 13-sectored version of WordStar) 

or 

DOS 33 or the language syston (for the 16-sectored version of 
WordStar) 

Note 

With either the language card or a 16K RAM card, more pages of text 
(about ten) can be put in memory for fast access. Without the addi- 
tional 16R, text access will be slowed down as fewer pages are held 
in memory and the computer must access the disk drive more often. 
(EXAMPLELIXT will not be available on the 13-sectored version.) 
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LsstaULation 

Upon receiving your i^pple II WordStar, £irst study the Microsoft CP/M Manual, 
then do the following: 

1. Format a blank diskette with the Microsoft FORMAT program (pp. 1-9 
in the Microsoft manual). 

2* Use the Microsoft COPY program to make a backup of the distribution 
WordStar diskette (pp. 1-10 in the Microsoft manual). 

3. Place an image of your Microsoft CP/M operating systen on the backup 
diskette. 

a. Do this by running the COPY program again; but this time, use 
the /S option (see COPY in the Microsoft CP/M manual. 

b. Hie /S function copies only the operating system to the backup 
diskette, rather than the entire disk. 

c. If you forget to use the /S for this step, you will just copy 
the CP/M disk onto your WordStar disk again. 

4. Ban the INSC7LL program by typing TyiSTRT.T. and pressing RETDHN 
(Section 14 of 1±is manual). 

Ordinarily, INSEJLL takes the original distribution file (WSO.ODM) and writes 
a new file for a particular system (WS.OOM or some other name). But because 
of the the limited capacity of an PspgLe II diskette (especially the 13-sector 
formatted version), you will have to use the same. file name (WSU.O0M) to put 
the newly installed WordStar back onto the disk. Steps 5-7 may be used: 

5. Press N (for NG) to get to the WordStar installation options menu. 

6. Press D to select installation option D (writing back to the same 
file— Section 14). 

7. TJie computer will ask you for the name of the file that you are 
installing. T^pe WSPaCQM and press RETDPN. 

A set of choices about the way your system is set up will appear on the 
screen. Now you should see Terminal Menu 1. Press 2. to move on to 
Terminal Menu 3, then select "=" to get the Apple II menu, which is the 
one that you use to select the 80-column video board. 

8. In the Apple II menu, select the appropriate combination of 80- 
column videocard, upper/lower (D/L) case conversion method and 
availability of shift key modification (optional but recommended for 
extaisive use of the shift function). 

There are two major classes of video boards, r^>resented by the following two 
products: 

o Videx Videoterm (cursor on) 

o M&R sap*R'Term (cursor off) 
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The first class (Videoterm) leaves the cursor on at all times. This should be 
your first choice for a trial video board if you are not using either of the 
video cards named above* If you cannot see the cursor, try the other option 
(Sup'R'Term) • 

If you have the hardware to generate Icwer-case, then select the "hardware D/L 
conversion" option; otherwise, select the "software U/L conversion" option to 
allow WordStar to perform the conversion. Finally, by using the very siirple 
shift key modification (see your Apple dealer) , you can enable the software 
U/L conversion to use the SHIFT key instead of the ESC key to perform the 
shift function. JUst select the "shift key mod" option. 

10. Make the desired printer selections (Section 14) and complete 
installation in the usual manner. 

11. Finally, after exiting to the operating system, rename the file 
(from WSD.COM to WS.COM). 

The ^agglB U Kestoazd 

The Apple II lacks sane keys found on most terminals. In particular, there is 
no provision for generating lower case or a number of special characters. If 
the "software U/L case conversion" option was selected during installation, 
then WordStar will provide for generation of lower case, as well as the full 
ASCII character set. 

The ESC key is used b y the Apple II for the shift lock/unlock function. In 
addition if the SEXET key modification is not installed then ESC also doubles 
as the shift key. In this case, press ESC twice for shift lock and once for 
regular shift. Note that the ESC key is also used for WordStar functions. 
Whenever you press ESC for a WordStar function, an additional press or two 
will be needed to return to the proper upper/lower case mode. (A little 
experimentation here can be helpful.) 

The LEFT ARROW key, which was previously a backspace (CTRL H), has been 
translated to give the RDBOUT code. This allows LEFT ARROW to be used to 
delete a character to the left of the cursor. If the SHIFT key modification 
has been made the FORWARD ARR(^ key can move the cursor to the right without 
altering the text under it. 

The nine l^Sdl characters not usually available from the i^pple II Keyboard are 
software generated in the lode mode. 

WordStar has adapted the alEha locK function (using the ESC key as described 
above) to give you the complete set of possible characters, including some 
that don't appear on the Apple II keyboard. For example, normally you get an 
exclamation point when you hold the SHIFT key down and press 1* However, when 
you are in alpha lock mode, you will see a vertical line instead on the 
screen. The same principle applies in the following cases: 
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SHIET Key in Alpha Lock Mode 

Vertical Line (1) 

Opening single quote (*)* 

Dhderline Lj 

Backslash (\) 

Left Brace ({) 

Right Brace (}) 

Left Square Bracket ( [) 

Right Square Bracket (]) 

Tilde (-) 

* Cannot be displ^ed by the Skip'R'Tlerm; you will see a space instead. 

To type "@" and "^," use alpha lock mode with the shift key depressedr just as 
the key tops indicate. 
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SHIET Key in Qilodced Mode 


■1" 


Exclamation Point (1) 


"7" 


Closing single quote (') 


"a" 


Equal Sign (») 


"?" 


Question Mark (?) 


"8" 


Tpft Parenthesis ( () 


"9" 


Right Parenthesis () ) 


n u 
r 


Left Angle Bracket «) 


If If 

• 


Right Angle Bracket (» 


"M" 


Capital "M" (M) 
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Appendix C 
Specific Terminals 



ESPLAHATION 



This appendix describes features available and gives configuration hints for 
many of the terminals on INS£2VLL's terminal menu. 

Note 

If your terminal had an auto line feed switch, make sure it is GPP* 

THE TESMIHALS 

Bedilve 150 

No highlightingr erase to ECLr or line insert/delete inplementeiS* 

Craiienioo3100 

Same as Beehive 150* 

Bazeltine 1500 

ADTO LINE FEED switch (under little cover above keyboard) must be OFF. 
Highlighted text displays dim. Erase end line and line InserVdelete are used. 

Hew letb-Sadeaid 2621 il/P 

No highlighting, erase ECL, or line insert/delete impleneited. 

msAivio 

This includes the IMSAI VDP-40, VDP-80, PCS 80/30, and other integrated systems 
containing the VIO display board. Highlighting and cursor display is by in- 
verse video; WordStar blii^ the cursor when necessary to distinguish it from 
highlighted areas. The video BM/i is accessed directly at F000 hex, producing 
fast screen update. The VIO must have the firmware ROM (as it always does in 
the above integrated systems), or equivalent routines must be present in your 
operating system. 

mf oton 1-100 

Highlighted text displays dim; line insert/delete are implemented. 

Lear-Slegler ADH-SA 

The CURSOR CONTROL switch inside the terminal must be ON; the SPACE/ADVANCE 
switch should be set to SPACE. No highlighting. 
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Lear-Slegler lUDM-Sl 

Highli^ted areas display dinu Erase end line and line insert/delete are used, 

NicroTbrm ACT IV 

Highlighted text displays dim^ assuming terminal was in dim state when WordStar 
invoked. Erase end line implemented; terminal does not have line insert/delete 
invocable from CEU. 

Processor Itecfanology VIM / SCL 

The VDM is accessed through the operating system; 06 hex is sent to clear the 
screenr escape r 2, line number r escape f 1, column number is sent to position 
the cursor. Mb other functions are implemented, WordStar's working with the 
VDM depends on the particular adaptation of CP/M to the VDM not interfering; in 
particular, transmission of all line feeds and all non-redundant carriage 
returns must occur. 

SOEOC JQ-l^B 

No highlighting/ erase ECLr or line inserVdelete implemented. 
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Appendix D 
Specific Printers 

DAISY WHEEL AND SIMILAR PRINTERS 

Features 

All printers described in this section support all of WordStar's print enhance- 
ments and other featureSf as described in the Reference Manual, except as noted 
in individual descriptions below. All printers described here will print 
bidirectionally; "formed" text will printed with Microspace justification. 

Choice of Typevheels 

The interchangeable typewheels for daisy printers come in many choices of 
characters and character arrangements. The printed characters will match those 
seen on the screen during editing only if the typewheel in use contains the 
standard ASCII characters in the standard ASCII order. Some typewheels have 
other character graphics; many have a different character arrangment so that, 
for example, a period in the docum^it will print as some other character. Some 
compatible typewheels for each printer are listed below. 

OEM DAISY WHEEL AND SIMILAR PRINTERS 

WordStar can drive the following "^EM" (Orginal Equipment Manufacturer) daisy 
wheel and similar printer models when interfaced with the MicroPro "VO Master" 
interface board: 

Diablo Hy-Type II 1300 Series 
Qume Sprint 3 (with cable adapter) 
Nee Spinwriter 5500D 

The OEM printers provide siirple installation and unexcelled performance with 
WordStar and are generally the least expoisive to buy; their chief disadvantage 
is that they are more difficult to drive from other software than other types 
of printers. 

The above printers have a 24-bit parallel interface using a very different 
command structure from that of all other printers supported by WordStar. Che 
installation selection specifies any of these printerSf selects the OEM printer 
driver in WordStar, and specifies the "I/O Master" (or IMSAI PIO-4) interface 
board. When installed for an OEM printer, WordStar accesses the printer 
interface directly. No operating system routines are used, and many 
installation complications are thus avoided. A "printer busy test" is 
provided, resulting in good response when editing and printing simultaneously. 

Interfacing 

For any of the OEM printers listed above, use the MicroPro "I/O Master" inter- 
face board with the OEM printer ports addressed at F8 through FA hex. Connect 
the interface board to the printer with the MicroPro printer cable (using an 
adapter as noted below with the Qume Sprint 3). 
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An IMSM PI04 board addressed at ports F8 through FB may also be used? the 
cable required is the same as the cable previously supplied by IMSAIr plus an 
additional conductor bringing the printer's "cfeta 1/2" bit to bit 4 of port P9. 

Installation 

To install WordStar to drive any of the OEM printers listed above through 
either of the interfaces listed above, select "I/O Master / OEM Printer" at 
INSERLL's printer menu (see "Printer-Related SelectionSr" Section 3), The same 
selection works with all the supported OEM printers and interfaces. The OEM 
daisy printer driver is pre-cortfigured for the standard OEM printer port 
numbers and bit assignments used with the "I/O Master" interface. (Extoisive 
modification would be required to drive another interface or to change the port 
numbers. A listing of the code that would require modification is available in 
the wcrdstag CustPinization tfetesJ 

Diablo Hy-Type II (1300 Series) 

The MicroPro printer cable can be used. 

cogj^riBLE TVP^v/H^;^;llS 

Diablo 38100 Courier 10 

Diablo 38107 Courier 72 

Diablo 38101 Pica 10 

Diablo 38102 Elite 12 

Qume 82167 Prestige Elite 12 

Qume Sprint 3 

IMTSRFftCIMS 

The cable adapter (available from Qume) that provides a Diablo-compatible 
termination from this printer's connector is necessary in order to mate with 
the MicroPro printer cable. 

OT^PiTTPiriFi TYPfMTOTrfi 

Compatible l^pewheels for the Qume Sprint 3 are as listed above for the Diablo 
Hy-T^e II. 

NEC Spinwriter 5500D 

INTERFACnqS 

The MicroPro printer cable can be used. 

This is the Hy-Tiype-II-compatible version of NECs OEM thimble printer. 

The NEC 5500D will buzz and stop printing if the (carbon) ribbon is used up, 
the paper runs out, or the cover is opened. Install a new ribbon, new paper, 
or close the cover, and printing will continue with no character loss. 
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SERIAL DAISY WHEEL AND 
SmiLAR PRIHTERS 

The descriptions in this section ^5ply to the following pr inters , which have 
"serial" interfaces: 

Diablo 1610/1620/1640/1650 

Qume Sprint 5 

Nee Spinwriter 5510/20 

Some of the manufacturers also supply equivalent versions with an 8-bit 
parallel interface; installation should be similar to the serial versions and 
the descriptions here should be generally applicable. 

Controls 

Most serial daisy wheel and similar printers have a control panel including 
some or all of the following switches: 

ADTO LE: must be CPP. 

ADTD ^: should be CFF. 

Lin<a Spacing 6/8 Lines per inch 

Character Pitch 10/12 Qaracters sol iacli 

These switches have MO EFFECT on printing under WordStar. Character and 
line spacing under WordStar always default to 6 lines per inch and 10 
characters per inch respectively, and may be modified via print directives 
imbedded in each document (Reference Manual). After printing with 
WordStar, the printer is left set to the switch settings for use with 
other software, except as noted below. 

FORM T.PTqr7m« set to match length of paper in use — commonly 11 inches or 
66 lines; setting does not matter if USE FOPH FEEDS print option (Section 
11) will not be used and you don't wish the SSL switch to work. 

SET TDF; depress after positioning paper at top of form; necessary only 
if USE FORM FEEDS print option is to be used or you wish the ££ switch 
to work. 

£E or FORM FEED ; depress to feed paper to top of form, e.g. after 
aborting print. 

Installation 

All daisy wheel and similar printers interfaced at 1200 baud (120 characters 
per second) must be installed with a "communications protocol" (as discussed in 
Section 2) in order to avoid buffer overrun and consequent character loss (a 
possible exception for the NEC is noted below). At speeds slower than 1200 
baud, these printers print slowly; you will find the effort invested to install 
one of these printers with a communications protocol rewarding because of the 
markedly increased printing speed. 

D-3 



Appendix D Printers 



Caution 

Do not attempt to use ETDC/ACK protocol in your operating system when 
driving a Diablo or Qume printer from WordStar. It won't work. If 
your operating system already can drive a Diablo or Qume printer at 
1200 baud through the use of ETX/ACK protocolr the portion of the 
operating system which implements the protocol must be disabled or 
bypassed when printing from WordStar. 

This limitation does not apply to XON/XOFF protocol r nor to NEC 
printers. (The reason for this limitation is that if an "ETX" in- 
serted in the character stream happens to fall within an "escape 
sequence" being transmitted to the printer, the printer will not 
recognize it as an ETXr and not respond with an ACK; nor will the 
printer interpret the escape sequence correctly. Keeping the ETX's 
out of the escape sequences is practical only in the program genera- 
ting the character stream; WordStar contains the necessary special 
code.) 

Diablo 1610/1620 

The "phantom space" and "phantom rubout" features of WordStar 
(Beference Manual) are not supported by these printers. 

After printingr WordStar leaves these printers set for 6 lines per inch and 10 
diaracters per inch. To set the character spacing according to the printer's 
"spacing 10/12" switch before use of other software, depress the "Clear" 
button. If other software has printed on the printer since it was powered up 
and before WordStar prints, you may, in unusual cases, find it necessary to 
press the printer's "clear" button, or to turn the printer off and on, before 
WordStar will print correctly (this is because the Diablo 1610/20 has no 
provision for a full reset initiated from the computer). 

TNfTTTiTiTiATTON 

When installing WordStar to use a Diablo 1610/1620 printer interfaced at 1200 
baud (120 characters per second), specify "ETX/ACK" protocol, and a driver 
capable of inputting characters, as discussed in Section 14. No settings are 
required on the printer for ETS^^^CK operation. These printers do not support 
XON/XOFF protocol. 

CCMPi^IIBLS TYPflWFnWfi 

Compatible T^pewheels for the Diablo 1610/1620 includes 

Diablo 38100 Courier 10 

Diablo 38107 Courier 72 

Diablo 38101 Pica 10 

Diablo 38102 Elite 12 

Qume 82167 Prestige Elite 12 
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Diablo 1640/1650 

FSKTORES 

Form Feeds cannot be used with the Diablo 1640 and 1650; the USE FORM FEEDS 
question does not occur in the print initiation dialog (Reference Manual) when 
WordStar has been installed for a 1640 or 1650. 

When installing WordStar to use a Diablo 1640/1650 printer interfaced at 1200 
baud (120 characters per second), specify "ETX/ACK" protocol, and a driver 
capable of inputting characters r as discussed in Sections 2-5. A switch set- 
ting may be necessary inside the printer to enable ETX/i%C3C protocol (switch 2 
on the HPR04 circuit board, if operator control panel is fitted, or as de- 
scribed in your Diablo manual). These printers also support XOtV^CFF protocol 
(Diablo calls it DC1/DC3 protocol) ; a switch setting is necessary inside the 
printer to enable this protocol (switch 3 on HPR04 circuit board, or as de- 
scribed in your Diablo manual). 

<Tf1P^TT?!riF; TYPfMWTiS 

Ccnpatible typewheels for the Diablo 1640 are as listed for the 1610/20 abcve. 

Qume Sprint 5 

When installing WordStar to use a Qume Sprint 5 interfaced at 1200 baud (120 
characters per second) , specify "ETX/ACK" protocol, and a driver capable of 
inputting characters, as discussed in Sections 2-5. Ito settings are required 
on the printer for ETX/ACK operation. The Qume Sprint 5 does not support 
XON/XOPP protocol. 

nwftTTTiriFi TYP^^yH^;^;lfi 

Compatible Typewheels for the Qume are as listed above for the Diablo 1610/20* 

NEC Spinwriter 5510/5520 

FEfllCRES 

The "phantom space and "phantom rubout" features (Reference Manual) are not 
supported on, nor relevant to, these printers. 

When WordStar is installed for a NEC spinwriter 5510/5520, two of the User 
Printer Function print control diaracters (Section 10) are defined as follows 
to permit access to additional characters on NEC print thimbles (typing 
elements) with more than 94 graphics: 

'*Q sends "shift out" code to printer; changes to alternate char- 
acter definitions, as described in your NEC documentation, until 
"W is aicountered in document. 
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'V sends "shift in" code to printer? restores normal character 
definitions after use of "Q» 

The NEC 5510/5520 will buzz and stop printing if the (carbon) ribbon is used 
upf the paper runs out, or the cover is opened. Install a new ribbon, new 
paper, or close the cover, then press the "Reset" switch, and printing will 
continue with no character loss. 



When installing WordStar to use a NEC Spinwriter 5510/5520 at 1200 baud (120 
characters per second), a communications protocol or a special cable must be 
used to prevent buffer overrun and character loss. The NEC printer is extreme- 
ly versatile; we know of four possible solutions to the buffer overrun problem: 

1. Check that the printer is set to use ETX/ACK protocol (switch 4 OFF 
on DIP switch SWl on the circuit board behind the control panel, or 
as described in the NEC documentation). In the WordStar installation 
dialog, specify ETX/ACK protocol and a driver that can input 
characters from the printer (as discussed in Section 2-4). We sug- 
gest this as the normal solution. 

2. Set the printer for XOI^/XDFF protocol (switch 4 CN on DIP switch SWl 
on the circuit board behind the control panel, or as described in the 
NEC documentation). In the WordStar installation dialog, specify 
XON/XOFF protocol and a driver tliat can input characters from the 
printer (as discussed in Section 2-4). 

3. ETX/ACK or XON/XOFF protocol implemented in a printer driver 
installed in your operating system may also be used with a NEC 
printer. In this case, specify "None" for protocol in the WordStar 
installation dialog. 

4. This is a hardware solution, requiring fabrication of a cable 
adapter. It may not work in all cases; if it works in your case it 
has the advantages that it works with other software in addition to 
WordStar, and that no communications protocol, nor a printer driver 
that can input characters, need be specified in WordStar 
installation. 

5. Make up a cable adapter which runs the printer's "Reverse Channel" 
signal (line 19 ot EIA connector) into the "Request to Send" line 
(pin 4 of EIA connector) of the computer's serial interface. Check 
that the printer is set to produce a "low" signal on buffer full 
(switch 5 OFF on DIP switch SWl on the circuit board behind the 
control panel, or as described in the NEC documentation). This 
signal will cause the USART in the computer's serial interface to 
stop sending diaracters when the printer cannot accept them, without 
ax^ special software considerations. 
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TELBTyPB-LIKE (NON-DAISY) PRINTERS 

The term *reletype-like" printer includes almost any printer designed to be 
connected to a microcomputer. OSie printer should return the carriage to the 
beginning of the line without advancii^ the paper upon receipt of a "carriage 
return code"/ advance the paper one line upon receipt of a "line feed" code, 
and print the appropriate character upon receipt of ASCII codes 20 through 7E 
hex. With such a printer, WordStar will not Microspace Justify nor print using 
variable line height nor variable character pitch. Subscripts and superscripts 
are printed in-line, or in the line below or above if it is a blank line; 
boldface is printed by overprinting the same characters three times; backspace 
is suppoi±ed only if the printer can backspace. 

If your printer has an ADTO LP switch, make sure it is OFF. 

The following special features of specific Teletype-like printers may be 
supported via special installation (patching) done by the user as discussed in 
Sections 6-8: 

Choice of TWO character pitches via "A and "N print controls 

Choice of two ribbon colors via '^Y print control 

Ability to feed paper up and down a fractional line for superscripts and 

subscripts 
Dp to 4 other special features via '^Q, '^W, **£, ^ print controls 

Any printer shown explicitly in WordStar's printer selection menu should be 
installed with the appropriate selection, rather than as '•Teletype-like", to 
make its full capabilities available. 

■Any Teletype-like Printer" 

This menu selection will drive any printer meeting the above description, with 
the limitations noted above. Use it when no other selections match or v^ien in 
doubt about the applicability of other selections. 

"Teletype-like Printer 
That Can Backspace" 

This menu selection is preferred for printers that can back up the carriage to 
the preceding character position on the same line upon receipt of an ASCII 
"backspace" code (08 hex). Use of this selection will yield faster printing of 
underline, boldface, and double strike, and makes the "backspace" print control 
available. 



OTHER PRINTERS 

Non-Retnrn Printers 

WordStar provides limited support of printers that cannot return the carriage 
without advancing the paper, such as Selectrics. If the printer can backspace, 
install as "Teletype-like printer that can backspace" and avoid use of over- 
print lines (Reference Manual). Other print enhancements will work as de- 
scribed for TTeletype-like" printers. If printer cannot backspace, install as 
"Any Teletype-like printer" and avoid use of underline, strike out, double 
strike, bold face, backspace, and overprint lines in your documents. 
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■Half -Line-Peed Printer" 

This menu selection is provided for use with printers that advance one-half 
line at a timer such as a Selectric with a half-line ratchet. Backspacing 
capability is also assumed by this menu selectionr but no ability to feed paper 
backwards is required. The half-line advance is utilized to print superscripts 
and subscripts half a line above and below, respectively, the rest of the text. 
Two line feeds are transmitted between lines where no subscripts and super- 
scripts appear. Depending on the characters your interface is equipped to 
respond to, patching may be required after this selection is made? see Sections 
6-8. 
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Appendix E 
The Terainal Patch Area (USBRl) 

A listing of the WordStar user-modifiable module USERl follows this page. 
This assenbly listing is supplied for the convenience of the occasional user 
who may need to install WordStar for an unusual terminal or printer. Note that 
this listing is for the standard TBASE=100 Bex version* For the 1SS-80 Model I 
version, and the Heath 89 version origined at 4300 Hex, add 4200 Hex to all 
addresses shown in listings. For a discussion of this listing, see Sections 6- 
8. 

A separate publicationr wnrr!c;har Customization Notes, is directed towards OEM's 
and system programmers. The Customization Notes contain additional source 
listingSf including: 

o default areas 

o message files 

o keyboard dispatch tables 
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Appendix E USERl Listing 

nSERl 04/23/81 TERMIML PATCH AREA MCRO-80 3.13 PAGE 1 

TULE USERl 04/23/81 TERMINAL PATCH AREA 
; FOR WordStar RELEASE 3,0 May, 1981 

ENTRY HITEjWID, CLEADl,CLEAD2,CTRAn.,CB4LPG,LIN0FF,C0L0FF 
ENTET ASCDR,UCEPOS,ERAEOL,LINDEL,LININS,IVON,IVOFF 
ENTRY TBMINI,TRMDNI,INISDB,UNISUB,DELaiS,DELMIS 
ENTET DELL, DEL2,DEL3,DEL4, DELS ,NMDFUS,TCKFLG 
ENTRY USELST,MEMAPV,MEMADR,HIBI7,HIBCDR,CRBLI7,ZAFCIII 
ENTRY RDBFXF,RITXER,UCONO,UCONI,UCNSTA,SWIN,SWOnT 
ENTRY TRSCRS,TRSCIF,HE1SBS,AFLFLG,RSTFLG,DEFDSK,SCRLSZ 
ENTRY MOBFATjPBGMEM 

EXT ODTCHR, MEMORY 
UiOO TBASE EQU lOOH ;WHERE TO LOAD PROGRAM FOR NORMAL CP/M 

0000* ASEG U^SGUTTE CODE, FOR LISTING 

ORG TBASE-f 148H ;BBGINS AT 248 HEX OR 4448 HEX 
PAGE 63 ;SETS PAGE LENGIH 
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0248 



* • 

* USER-MDDIFIABLE CONSTANTS AND ROOTINES FOR * 

* HAEDWARE-DEPENDENT TERMINAL CHARACTERISTICS * 

* AND FDNCTIONS USED BY EDITOR * 

* * 

AAA ' AA*AAAAAAAAAAA ' AAAA*AAAAAAAAAAAAAAAA"AA ' AAAAAAA"AAAA 

;NOTE: THIS AREA IS NORMALLY PATCHED FOR YODR TERMINAL 
;TYPE VIA TEE INTERACTIVE INSTALL PROGRAM. ADDITIONAL 
;PATCHIN6 TO IHIS AREA IS NEEDED ONLY FOR UNOSHAL TERMINALS 
;0R UNUSUAL VIDEO BOARDS, OR TO MEET SPECIAL REQUIREMENTS 
;0R ENHANCE OR PERSONALIZE PERFORMANCE. 



PATCHES ALWAYS NEEDED: SCREEN HITE & WIDTH, CURSOR. 
ALL OTHERS ARE OPTIONS FOR SPECIAL CASES OR ENHANCEMENT. 



0248 
U249 



18 
50 



SCREEN SIZE 

SCREQI HEIGOr AND WIDTH PATCHES ARE MANDATORY. 



HITE: DB 24 ;MUST BE EXACT SCREEN HElGOT IN LINES 
WID: DB 80 ;MUST BE h' ESCACT SCREEN WIDTH 



IN ALL CHARACTER SIBLINGS TO BE SENT TO TERMINAL, 
FIRST BYTE IS NUMBER OF CHARACTERS, CHARACTERS FOIXOW. 
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PROVISIONS FOR PATCHING 
ODRSOR POSITIONING CONTROL SEQUENCES 

CUBSOR POSITIONING PATCH IS MANDAT0R7. 



CDRSOR POSITIONING FOR MOST TERMINALS 
IS ACCOMPLISHED B7 SENDING: 



1. A 



"LEAD-IN" STRING OF ONE OR MORE 

TERMINAL-SPECIFIC CHARACTERS; 



3, 
4. 
5- 



THE LINE NUMBER, WITH AN OFFSET (OFTEN 0) 
ADDED; OR, FOR SOME TERMINALS, 
TBE COLUMN NUMBER IS SENT FIRST; 

ANOTHER LEAD-IN STRING, FOR SOME TERMINALS; 

ISE COLUMN (OR LINE) NUMBER, WTIH OFFSET; 

ANOISER STRING (FOR SOME TERMINALS). 



FOR MOST TERMINALS, TEE LINE AND COLUMN ARE SENT 
AS l-BTTE BINARY NOMBERS; FOR A FEt? TERMINATE, 
TWO- OR OHREE-DIGIT ASCII NUMBERS ABE SENT. 

FOR TERMINALS THAT DON'T FIT TBE ABOVE PATTERNS, 
70a MUST CODE TOUR ONN SUBROUTINE. 



;CURSOR PATCH AREAS ABE ON NE2I PAGE 
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024^ 


02 


024B 


IB 


024C 


3D 


024D 


00 00 00 


0250 


00 00 00 



CDRSOR POSmONINS. . . 

SEE COMMENTS PRECEDING PAGE 

FOR EXAMPLE, THE CURSOR IS POSITIONED ON THE 
ADMh3A TERMINAL B7 SENDING: 

ESCAPE, -, 

LINE # PLUS 20 HEX, 

COLUMN NUMBER PLUS 20 HEX, 
THE FOLLOWING PATCH AREAS ARE SET UP FOR THIS 
TERMINAL, AS AN EXAMPLE. 

CURSOR POSITIONING INITIAL LEAD-IN STRING 
CLEADl: DB 2 ;NUMBER OF CHARACTERS 



DB IBH 
DB •-• 
DB 0,0,0 
DB 0,0,0 



FIRST CHARACTER 
SECOND CHARACTER 
SPACE FOR MORE 
.. CHARACTERS 



0253 00 

02!)4 00 

0255 00 00 00 



; CURSOR POSITIONING STRING SENT BETHEEN 
; LINE AND COLUMN 



CLEAD2: DB 



;NUMBER OF CHARACTERS - 
; NONE IN OUR EXAMPLE 
DB ;F1SST CHARACTER 

DB 0,0,0 ;SECOND THRU 4^ 



U258 00 

0259 00 00 00 00 



; CURSOR POSITIONING STRING SENT AFTER 
; BOm LINE AND COLUMN HAVE BEEN SENT 
CIBAIL: DB ;NUMBER OF CHARACTERS (NONE) 
DB 0,0,0,0 



025D 00 



; FLAG NON-ZERO TO SEND COLUMN BEFORE LINE 
CB4LFG: DB ;LINE GOES BEFORE 

;. .COLUMN IN OOR EXAMPLE 



025E 20 



; OFFSET TO ADD TO LINE 

LINOFF: DB 20H ;ADD THIS TO LINE f 

;(yHERE IS TOP LINE ON 
; SCREEN BEFORE OFFSET) 



025F 20 



OFFSET TO ADD TO COLUMN 



COLOFF: DB 20H 



ADD THIS TO COLUMN # 
(\jHERE IS LEFT EDGE OF 
SCREEN BEFORE OFFSET) 



026U 00 



; BINABT / ASCII FLAG AND # ASCII DIGITS 
ASCUR: DB ;ZERO TO SEND BINARY LINE & COLUMN 
;2 TO SEND 2-DIGIT ASCII NUMBERS 
;3 TO SEND 3-DIGIT ASCII NUMBERS 



;SEE NEXT PAGE FOR POSITIONING 
;CURSOR VIA USER-CODED SUBROUTINE 
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0261 00 00 00 



0264 00 

0265 00 

0266 C9 



; CURSOR POSmONING. . . 

DB 0,0,0 ;BYTES RESERVED FOR EXPANSION 

PROVISION FOR POSITIONING CURSOR BY USER-CODED 
SOBROOTINE INSTEAD OF UNDER CONTROL OF ABOVE ITEMS, 
FOR USE IN EXCEPTIONAL CASES ONLY: 



IN 



PUT A JMP INSTRUCTION TO YOUR SUBROUTINE 
FOLLOWING 3 BYTES. WHENEVER FIRST BYTE IS 
NOR-0, mis LOCATION WILL BE CALLED TO POSITION 
CURSOR; ABOVE CURSOR PATCH ITEMS WILL BE DISREGARDED. 



UCBPOS: NOP ;NOHMALLY 0, OR JMP TO YOUR 
NOP ;SPECIAL CURSOR POSITIONING 
RET ;ROnTINE. 



; SEE "MDRPAT** AT THE END OF THIS LISTING 
; FOR SPACE TO PUT YOUR SUBROUTINE IN. 



0267 0000* 



YOUR SUBRCOTINE WILL RECEIVE LINE IN L REGISTER 
(0-TOP SCREEN), COLUMN IN H (0-LEFT EDGE). 

YOUR SUBROUTINE MAY ALTER ALL REGISTERS. 

TO OUTPUT A CHARACTER TO TSZ TERMINAL FROM WITHIN 
YOUR SUBROUTINE, CALL OUTCHR. EXAMINE THE F0LLGUIN6 
2 BTTES Wrm YOUR DEBUGGER TO DETERMINE IBE ADIfiESS 
TO CALL IN CURRENT RELEASE OF WORDSTAR: 

EW OUTCHR ;ADrB£SS OF BYTE OUTPUT 
;ROUTINE LOADED HERE 



YOUR CUSTOM CURSOR POSITIONING ROUTINE WILL ALSO 
RECEIVE THE FOLLWING, WHICH MIGHT BE USEFUL 
IN SPECIAL VIDEO BOARD DRIVERS: 

DE-NUMBER OF CHAR POSITIONS iROM BEGINNING OF SCREEN 

TO NEW CURSOR POSITION (0«UPPER LEFT CORNER). 
BC*NUMBER OF CHAR POSITIONS I^QM BEGINNING SCSEM TO 
BEGINNING OF LINE IN WHICH CURSOR IS BEING PLACED. 



0269 



00 00 00 00 



DB 0,0,0,0 



;RESERVED BYTES 
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EVER^TUiG THAT FOLLOWS IS OPTIONAL. 

EA,CH ITEMS RELATE Ei'lTiKK TO ENHANCED PERTOBM- 
ANCE (FOR EXAMPLE, USE OF INVERSE VIDEO 
OR BRIGHT/DIM TO SET OFF BLOCKS OF TEXT), 
OR TO ACCOHDDATING UNUSUAL TERMINALS. 



026D 


00 


02faE 


00 


026F 


00 


0270 


00 00 00 00 



; ERASE TO END OF LINE. OPTIONAL - IF FUNCTION 
;NOT AVAILABLE, LEAVE FIRST BTJTE ZERO AND EDITOR 
;WILL DO THE FUNCTION MORE SLOWLY VIA SOFTWARE. 

ERAEOL: DB ;PUT NUMBER OF CHARCTERS HERE 
DB ;PUT FIRST CHARACTER HERE 
DB ;IF 2-CHAR SEQUENCE, PUT 2ND HERE 
DB 0,0,0,0 ;IF 3 TO 6 CHAR SEQUENCE, 
;PUT ADDITIONAL CHARS HERE. 



;DELETE SCREEN LINE CONTAINING CRSOR, MOVE 
;LOWER LINES ON SCREEN UP ONE LINE. OPTIONAL. 
;SUPFL7ING IHIS SPEEDS SCREEN UPDATE. 



0274 


00 


LINDEL: DB 


0275 


00 00 00 


DB 0,0,0 


0278 


UO 00 00 


DB 0,0,0 



;PUT LENGTH TfvaRV 

; SPACE FOR l'-6 CHARACTERS 



;INSEBZ A BLEK LINE ON SCREM, MOVING CURSOR 
;LINE AND LINES BELOW IT DOWN ONE. OPTIONAL. 
;SDPPLZING THIS SPEEDS SCREEN UPDATE. 
;N. B. IF TOUR TERMINAL INSERTS BELOW THE 
;CURSOR LINE, WZ A "CURSOR UP'* BEFORE TEE 
; "INSERT LINE" CHABACTER(S). 



027B 


00 


LLNINS: DB 


027C 


UO UO 00 00 


DB 0,0,0,0 


0280 


00 00 00 00 


DB 0,0,0,0 



;PUT LENGTH F^^K 

;SPACE FOR 1-^ CHARACTERTS 
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0284 


00 


0285 


00 00 00 


02S8 


UO 00 00 



028B 


00 


028C 


00 00 00 


028F 


00 00 00 



;TnEN GN HIGHLIGBTING (INVERSE VIDEO, BRIGHI/DIH, OR 
;OTHER MEANS OF HIGHLIGHTING A SECTION OF TEXT) . 
-.APPLICABLE ONLY IF MEMAPV (NEXT PAGE) IS 0, OPTIONAL. 



IVCN: 



DB 

DB 0,0,0 

DB 0,0,0 



;LENGTH 

;IIP TO 6 CHAEACTERS 



;TDBN OFF HIGLHLIGHTING. OPTIONAL. 

;IF NO STRING PATCHED IN, I70N STRING WILL BE 

;nSED TO TDRN OFF AS li^ELL AS ON. 



I70FF: 



DB 

DB 0,0,0 

DB 0,0,0 



;IENGTH 

;UP TO 6 CHARACTERS 



0292 


00 


0293 


00 00 00 00 


0297 


00 00 00 00 



029B 


00 


029C 


00 00 00 00 


02AO 


UO 00 00 00 



;TEEMINAL INITIALIZATION STRING: ANY BYTES YOD 
;WANT SENT TO YOOR TERMINAL AT BEGINNING OF 
;SESSION. OPTIONAL. SEE ALSO INISDB, NEXT PAGE, 
TBMINI: DB ;LENGTH 

DB 0,0,0,0 ;IHE BYTES, 
DB 0,0,0,0 ;m2i LENGTH 8. 

;AN^r BYTES YOU U&NT SENT TO TERMINAL AT END OF 
; SESSION. OPTIONAL. SEE ALSO UNISUB 
IBMDNI: DB ;LEIIG1B 

DB 0,0,0,0 ;1SE BYTES, 

DB 0,0,0,0 ;DP TO 8. 



02A4 00 
02A5 00 
02A6 C9 



02A7 00 
02A8 00 
02A9 C9 



nSER-FATCHABI£ INITIALIZATIGN SDBRCOTINE. CALLED 
JDST BEFORE T8MINI (PREVIOUS PAGE) IS SENT, THIS 
SDBRODTINE MAY BE USED FOR SPECIAL CONSOLE INIT- 
IALIZATION OR OTSER PURPOSES. 

INISUB: NOP ;ENTS7 POUTT. PUT DESIRED CODE IN 
NOQP ;"MORPAT" AREA (3 PAGES AHEAD IN 
RET ;1HIS LISTING) AND PATCH IN A "JMP" 
; INSTRUCTION HERE. FOR YET MORE 
;SFACE, SEE "PBCMEM" ON SAME PAGE. 

USER-PATCHABLE DE-INITIALIZATION SUBROUTINE. 
CALLED AT EXIT (JUST BEFORE TRMUNI IS SENT) , 
mis SUBROUTINE MAY BE USED TO "UNDO" ANY SPECIAL 
TEEQONAL STATUS USED IN THE EDITOR. 



UNISUB: NOP 
NOP 

RET 



PUT DESIRED CODE IN 
"•MORPAT* AREA, PATCH IN 
A "JMP" HERE. 
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MISCELIAflEOUS TERM]MIr*RELATED ITEtS 



;FLAG TO PEBMIT DISPLAY IN LAST COLUMN OF LAST LINE. 
;INrriALL7 DISABLED, AS MANY TERMINALS SCROLL SCREEN 
; WHEN A CHABACTER IS DISPLAYED IN THIS POSITION. 



02AA 



00 



USELST: DB 



PATCH NON-0 TO PERMIT LAST CHAR ON LAST 
LINE TO DISPLAY IF THIS WILL NOT SCROLL 
SCREEN OF YODR TERMINAL. NORMALLY LEAVE 
FOR USE WITH TERMINAL, PATCH NON-0 
FOR USE WITH MEMORY-^IAPPED VIDEO BOARD. 



02AB 



UO 00 00 



DB 0,0,0 



;BYTES RESERVED FOR EXPANSION 



02AE 
02AF 



QA 
05 



DELAYS E^CUTED AFTER VARIOUS TERMINAL FONCTIONS, 
BEFORE NEST CHAR IS SENT TO TERMINAL, TO ALLOW RESPONSE 
TIME REQUIRED BY CERTAIN TERMINALS WHEN USED AT E1(S. 
BAUD RATES. PATCH LARGER IF YOU EXPERIENCE, FOR 
EXAMPLE, LOSS OF CHARACTERS AFTER CURSOR POSITIONING. 
EACH DELAY IS APPROX NUMBER OF MILLISECONDS ON 
4 MHZ Z-80; DELAY IS ABOUT TWICE AS LONG ON 2 MHZ 8080. 



DELCUS: DB 10 
DELMIS: DB 5 



;10t- ISEC DELAY AFTER CURSOR SET 
;5^ MSEC DKTAT AFTER OTHKR FUNCTIONS 
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0250 00 

0251 0000 



PR07ISI0NS FOR MEMDRT-MAPPED VIDEO BOARDS THAT MEET 
THE FOLLOWING RESTRICnONS: 

1. CHARACTERS POSITIONS APPEAR AS MEH3R7 LOCATIONS 
AT SEQUENTIAL INCREASINS ADEBESSES FROM A BASE. 

2. HIGHTilGHTING, IF USED, IS INVOKED B7 SKTl'lNG 
HIGH ORDER BIT OF CHARACTER. 

3. BOARD mST ALI^YS BE "MAPPED IN" 10 IHE ADISESS 
SPACE, OR IT MUST BE SWITCHAfiLE IN AT AN ADISESS 
ABOVE APPRQZ 8000 HEX AND ROUTINES MUST BE PATCHED 
IN AT "SWIH** AND "SWODT" ON PAGE 12 OR SO BELOW. 

IF MEMAPV IS NON-ZERO, WORDSTAR WILL STORE DIRECTLY 
INTO YOUR VIDEO BOARD RATHER THAN DOING CONSOLE ODTPUT 
VIA CP/M. mis IS WE BEST INSTALLATION METHOD FOR 
VIDEO BOARDS MEETING THE RESTRICTIONS. 

FOR INSTALLATION SUGGESTIONS FOR OIHER VIDEO BOARDS, 
SEE DISCUSSION NEAR END OF IHIS LISTING OR IN MANUAL. 



MEMAPV: DB ;NDN-0 TO USE MEaORT-MAPPED VIDEO DISPLAY 

;DISFUY BY DIRECT STORAGE METHOD. 
MEMADR: DW ;ADDRESS OF VIDEO SCREEN BAM, TOP LINE, 

;LEFI!CST COLUMN. IHE BEST OF IHE SCREEN 
;MUST BE AT CONTIGUOUS ASCENDIN5 ADEBESSES, 
WHEH USING MEMAPV, CHECK THE FOLLOWING ITEMS BELOW: 
HIBIV: NQN-0 FOR HIGH-BIT HILITING (DETAILS BELOW) 
HIBCUR: NQN-0 FOR SLGS-BIT CDRSOR 
CRBLIV: NON-0 TO BLINK CURSOR IF ON HTT.IGHTKU CHAR 
SWIN, SWOUT: ROUTINES TO SWITCH VIDEO BOARD INTO 
AND CUT OF ADISESS SPACE, IF NEEDED 
SETTING USELST ABOVE IS ALSO RECOMMENDED. 
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02B3 



00 



FLAG TO SAT HHVERSE VIDEO, HIGH BRIGHTNESS, OR OTHER 
MEANS OF HIGHLIC^TING CHARACTER WILL OCCUR IF HIGH 
ORDER BIT OF CONSOLE ODTPDT CHARACTER IS ON, 

INTEN15ED PRIMARILY FOR USE WHEN MEMAPV IS NON-ZERO 

(SEE IVDN/IVOFF ABOVE FOR HILITING ON TERMINALS) ; 

BUT MIGHT ALSO BE USEFUL WITH CUSTOM CONSOLE OUTPUT 

ROUTINE (UCONO, BELOW). 



ELBIV: DB ;PATCH NON-0 IF YOU HAVE INVERSE 

;VIDEO ETC. INVOKED BY HI ORDER BIT. 



02B4 



00 



FLAG TO INVOKE DISPLAY OF CURSOR ON MEMORT MAPPED 
VIDEO BOARD BY SETTING HIGH ORDER BIT OF CHARACTER 
UNDER CURSOR, RATHER THAN BY SENDING A CURSOR POSI- 
TIONING SOILING UNDER CONTROL OF THE PATCH ITEMS ON 
PAGES 3 AND 4. 

THIS SAVES TIME AND ELIMINATES INTERACTION PROBLEMS 

THAT CAN ARISE IF CHARACTER DISPLAY IS BY DIRECT 

STORAGE BUT CURSOR POSITIONING IS VIA IHE KJC'l'KKWAT. 

BOARD DRIVER. 
NOTE: CURSOR POSITION PATCHES SHOULD STILL BE INSTALLED 

TO INTERFACE TO Kn'EHNAL CURSOR POSITION FUNCTION; 

IT IS USED AT STARTUP AND EXIT TO PLACE INTERNAL AND 

EXTERNAL CURSORS IN SAME PLACE. 



HJBCDR: DB ;NON-0 TO DISPLAY CRSR BY SETTING 
;HIGH ORDER BIT OF CHARACTER. 
;AFFLICABLE IF MEMAPV, ABOVE, IS NON-0. 



02B5 00 



FLAG TO SAY CURSOR MUST BE BLINKED BY THE EDITOR 
IN ORDER TO BE VISIBLE WHEN ON OR ADJACENT TO AN 
INVERSE VIDEO (OR OTHERWISE HIGHLIGHTED) 
CHARACTER. THIS SHOULD BE OFFH IF YOUR CURSOR 
IS NOT VISUALLY DISTINCT FROM YOUR INVERSE VIDEO 
AND INVERSE VIDEO IS USED (VIA IVON/IVOFF OR HIBIV) , 
NORMALLY NEEDED WTIH MEMORY MAPPED VIDEO BOARDS 
WUH HIBIV AND HIBCUR BOTH OFFH. 
APPLICABLE TO BOTH TERMINALS AND VIDEO BOARDS. 
BLINK METHOD USED FOR A TERMINAL: ALTERNATELY 
SEND IVON, IVOFF STRINGS, WITH DELAYS. 



CRBLIV: DB ;FF HEK FOR EDITOR TO BLINK CURSOR 
;WHEN ON INVERSE VIDEO CHARACTER. 



SEE ALSO SWIN, SWOUT — 3 PAGES AHEAD 
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T^ SCHQIES FOR ClK.UJHVKN'riNG OPERATING STSTSUS 
THAT BACKSPACE WHEN '^DELETE" IS INPUT. 

A NUMBER OF PROPRTETAKT VERSIONS OF CP/M 
OUTPUT BACKSPACE, SPACE, BACKSPACE IN PLACE OF THE 
mE NEXT CHARACTER OUTPUT AFTER A '^DELETE" (RUBOUT) 
IS INPUT, THE CODE TO DO OHIS IS IN THE "BIOS" 
SECTION OF IDUR SYSTEM. 

THE DITENT OF THIS "FEATURE" IS TO MAKE THE 
"DELETE" KE7 ERASE A CHARACTER ON IHE SCREEN, 
INSTEAD OF ECHOING ISE DELETED CHARACTER, DURING 
SYSTQl COMMAND LINE INPUT. 

UNFORTUNATELY, THIS "FEATURE" CAUSES A MESS ON 
IHE SCSE£N AFTER THE DELETE KEY IS PRESSED IN WordStar, 
BECAUSE THE CHARACTER THAT YOUR SYSTEM REPLACES WITH 
BACKSPACE-SPACE-BACKSPACE IS USUALLY THE FIRST 
CHARACTER OF A CURSOR POSITIONING SEQUENCE BEING 
OUTPUT BY WordStar. 



THE "DELETE-BACKSPACE" FEATURE IHUS MUST BE DISABIZD 
CURING WordStar OPERATION; TfTO METHODS ARE: 

1. BY REFERRING TO YOUR "BIOS" LISTING IN YOUR 
SYSTEM DOCUMENTATION, INlDENTLbY THE LOCATION 
IN WEIGH YOUR OPERATING SYSTEM SAVES TEE LAST 
CHARACTER INPUT IN ORDER TO TEST FOR "DELETE" 

ON OUTPUT. IN SOffi SYSTEMS, THIS IS LOCATION 4F. 
PATCH ISIS ADDRESS, LOW (BDER BYTE FIRST, INTO 
"ZAFCIN" BELOW. 

2. PATCH "RDBFXF" BELOW TO NDN-ZERO. THE CONTENTS 
OF "RFI2ER" WHL THEN BE OUTPUT IMMEDIATELY 
AFTER A '*DELETE" IS INPUT; THIS CHARACTER, RAISER 
ISAN THE NEZT CURSOR POSITITIONING STRING, SHOULD 
ISUS BE REPLACED WITH BACKSPACE-SPACE-BACKSPACE, 
REDUCING ISE CONSEQUENCES OF YOUR SYSTEM'S 
MACHINATIONS. TRY NULL (ZERO) IN RFIXER FIRST; 

IF THIS DOESN'T WORK, TRY BACKSPACE (08) OR SPACE, 



02B6 0000 



ZAFCIN: EW ;ZERO OR POINTER TO LOCATION TO ZERO 

; AFTER EACH KEYBOARD CHARACTER IS INPUT 



02B8 00 
02B9 00 



RDBFXF: DB ;NOH-ZERO TO OUTPUT CHARACTER IN RFIXER 
; AFTER EACH "DELETE" IS INPUT. 

RFIXER: DB ;CHARACTER TO OUTPUT AFTER EACH "DELETE" 
; IS INPUT IF "RDBFXF" IS NDIH). 
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OPTIONAL USER-SDPPLIED CONSOLE I/O SDBKDDTINES, USER MAT 
PATCH JMP»S HERE TO HIS CWN CONSOLE INPUT, OUTPDT, AND 
STATUS ROUTINES, IN WHICH CASE ISESE ROUTINES INSTEAD OF 
THE OPERATING SYSTEM "BIOS" ENTET POINTS WILL BE USED FOR 
ALL CONSOLE I/O (EXCEPT I/O TO PRINTER INSTALLED AS ALTER- 
NATE CONSOLE). THESE ROUTINES MAY ALTER ALL REGISTERS. 



02BA 
02BB 
02BC 



00 
00 
C9 



; OPTIONAL USER CONSOLE CHARACTER READY ROUTINE 
UCNSTA; NOP ;NORMALLY 0, OR JUMP TO YODR OWN STATUS 
NOP ;SUBBOUTINK. MIST RETURN IN A 
RET ;IF NO CHAR READY, OFFH IF CHAR IS READY. 



02BD 
02BE 
02BF 



00 
00 
C9 



; OPTIONAL USER CONSOLE INPUT ROUTINE 

UCONI: NOP ;NORMALLY 0, OR JMP TO YOU OWN INPUT 

WV ; SUBROUTINE. MTST RETURN CHARACTER IN A. 

RET ;MAY BE CALLED BEFORE CHARACTER IS READY. 
;IF NO CHARACTER IS READY, ROUTINE MUST 
; WAIT UNTIL CHARACTER IS AVAHAHLE. 



0200 00 
02C1 00 
02C2 C9 



; OPTIONAL USER CONSOLE OUTPUT ROUTINE 

;USE OF A CUSTOM ROUTINE ACCESSED HERE IS SUGGESTED, 
;FOR EXAMPLE, TO DRIVE A VIDEO BOARD lEAT CANNOT BE 
;DRIVEN VU OUTPUT TO OPERATING SYSTEM AND WHICH DOES 
;NOT MEET RESTRICTIONS FOR USE OF "MEMAPV" ABOVE. 

UCONO:- NOP ;NORHALLY 0, ELSE JMP TO YOUR OWN CONSOLE 
NOP ;OUTPDT SUBRGOTINE. SUBROUTINE RECIEVES 
RET ;CHARACTER IN A; IF HI-BIT HIUTING IS IN 
;USE ("HIBIV" SET ABOVE), HI ORDER BIT 
;WILL BE ON IF CHAR SHOULD BE HTT.TTED. 



UCONO ALSO RECEIVES: L-LINE # ON SCREEN, H-CQLUMN #, 
DE«4 BYTES FROM BEGINNING OF SCREEN TO CHARACTER 
POSITION (0*^rOP LEFT), BC=»iP BYTES FRCM BEGINNING 
OF SCREEN TO BEGINNING OF CURRENT LINE 



UCONO ROUTINE MUST HANDLE IBE FOLLOWING CHARACTERS: 
ASCII PRINTING CHARACTERS 20H TMD 71ES: DISPLAY CHAR, 
ADVANCE CURSOR TO NEXT POSITION. HI ORDER BIT WILL 
BE 1 FOR HHJGHTED CHARS IF HIBIV, ABOVE, IS NZ. 
CR (ODH) : POSITION CURSOR AI BEGINNING OF SAME LINE 
LF (OAH) : MOVE CURSOR DOWN ONE LINE; OR, IF ALREADY 
ON BOTTOM LINE OF SCREEN, SCROLL SCREESI 
UP ONE LINE. 
PLUS ALL CONTROL SEQUENCES GENERATED BY CURSOR PATCH 
ITEMS ABOVE (UNLESS A CURSOR SUBROUTINE (UCRPOS) IS 
USED) AND OPTIONAL PATCH ITEMS ERAEOL, LINDEL, LININS, 
IVON, IVOFF, TRMINI, AND TRMDNI ABOVE. 
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02C3 


00 


02C4 


00 


02C5 


C9 


02C6 


UO 00 00 



PROVISIONS TO SWITCH A MEMDRT MAPPED VIDEO BQABD INTO 
AND OUT OF TBE ADDRESS SPACE. 

MOST VIDEO BOARDS ALWAYS APPEAR IN ME^£)R;. HOWEVER, 
CERTAIN BOARDS MUST BE "SWITCHED IN" TO BE ACCESSED AND 
"SWITCHED OUT" WHEN NOT BEING STORED INTO, SO THAT 
SYSTEM RCM OR BAM AT THE SAME ADIRESSES MAY BE ACCESSED. 

IF TDD HAVE A VIDEO BOARD THAT REQUIRES "SWITCHING 
IN" AND "SWrrCHIBG OCT", TBE BQABD MAY BE ACCESSED ON A 
DIRECT MEMORY MAPPED BASIS BY WORDSTAR WUHOUT LOSS OF 
USE OF MEMORY AT THE SAME ADDRESSES IF SUITABLE ROUTINES 
ARE INSTALLED FOR "SWIN** AND "SWDOT" BELOW. 

WHEN SWITCHED IN, THE ADERESSES OCCUPIED BY 1BE 
BOARD MOST NOT CONFLICT WTIH WORDSTAR'S CODE, THAT IS, 
THE BOARD MUST APPEAR AT OR ABOVE ABOUT 8000 HEX. 
IHE BQABD MAY, HOWEVER, APPEAR AT THE SAME ADmESSES 
AS lEE OPERATING SYSTEM. 

SEE "MEMAPV" AND OTHER ITE16 BEGINNING ON PAGE 8 
OR SO FOR OTHER ASPECTS OF INSTALLATION FOR DIRECT 
MEMORY ACCESS TO A VIDEO BOARD. 

SIX BYTES OF SPACE IS PROVIDED FOR EACH ROOTINE 
BELOW. IF ROOTIBE IS LONGER, PATCH IN A JMP TO A ROOTINE 
AT MORPAT OR ELSEHHERE. YOUR ROUTINES MUST PRESERVE ALL 
REGISTERS EXCEPT IHE PSW. WHEN NO ROUTINE IS PRESENT, 
"NOP, NOP, RET" SHOULD BE LEFT IN THE PATCH ITai. 
NO ROUTINES SHOULD BE INSTALLED EXCEPT WHEN A VIDEO 
BOARD IS BEBC USED ON A DIRECT MEMORY HAPPED BASIS. 

OPTIONAL ROUTINE CALLED BY WORDSTAR BEFORE EACH 
DIRECT MEMORY MAPPED ACCESS TO A VIDEO BOARD. 
THIS ROUTINE MAY SWITCH THE VIDEO BOARD INTO THE 
ADDRESS SPACE, POSSIBLY DISPLACING PART OF TEE 
SYSTEM'S RAM OR ROM ABOVE ABOUT 8000 HEX. 
ROUTINE MUST PRESERVE CONTENTS OF B,C,D,E,H, AND L. 
SWIN: NOP '.NORMALLY NOP, NOP, RET, OR 

NOP *,SWITCH-IN ROUTINE OF 6 BYTES 

RET ;0R LESS, OR JMP TO LONGER 

DB 0,0,0 ;ROUTINE. 



02C9 


00 


02CA 


00 


02CB 


C9 


02CC 


00 00 00 



OPTIONAL ROUTINE CALLED BY WORDSTAR AFTER EACH 
DIRECT MEMORY MAPPED ACCESS TO A VIDEO BOARD. 
THIS ROUTINE MAY SWITCH THE VIDEO BOARD OUT OF 
THE ADIBESS SPACE, TO ALLCW SUBSEQUENT ACCESS 
TO ANY RAM OR RCM THE VIDEO BQAiU) DISPLACED. 
ROUTINE MUST PRESERVE THE B,C,D,E,H, AND L REGISTERS. 
SWOUT: NOP ;NDRMALLY NOP, NOP, RET, OR 

NOP ;SWITCH-OUT ROUTINE OF 6 BYTES 

RET ;0R LESS, OR JMP TO LONGER 

DB 0,0,0 ;ROUTINE. 
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DELAYS FOR CURSOR BLINK, "NEW FILE" MESSAGE, ETC. 

THE FOLLOWING DELAYS MAT BE ALTERED TO ADJUST FOR 
VARIATIONS IN CPU SPEED AND FOR INDIVIDUAL PREFERANCES. 
EACH OF THE FOLLOWING FOUR ITE^S MAT BE SET TO VALUES 
BETWEEN 1 (MINIMDM DELAY) AND 127 (MAXEMDM DELAY), 
rr IS SUGGESTED THAT YOU RETAIN TBE APPROXIMAIE 
RELATIVE PROPORTIONS OF THE DELAYS. 



02CF 03 



02D0 09 



02D1 19 



DELI: DB 3 ;CONTROLS SHORT DELAY. USES INCLUDE: 

CURSOR BLINK (\JHES OS HILIGUTEU CHAR AND CRBLIV 
ABOVE IS NON-ZERO): "ON" PORTION OF CYCLE. 
CURSOR BLINK BETWEEN "REPLACE Y/N :" IN STATUS 
LINE AND FILE DISPLAY DURING REPLACE 
COMMAND («QA): TIME IN FILE DISPLAY AREA. 

DEL2: DB 9 ;CQNTRQLS MEDIUM-SHORT DELAY. USES INCLUDE: 
CURSOR BLINK (WHEN ON HILIGUTEU CHAR AND CRBLIV 

ABOVE IS NON-ZERO): "OFF" PORTION OF CYCLE. 
CURSOR BLINK BETWEEN "REPLACE Y/N:" IN STATUS 
LINE AND FILE DISPLAY DURING REPLACE 
COMMAND C^A): TIME IN STATUS LINE. 

DEL3: DB 25 ;CONTROLS MEDIUM-LONG DELAY. USES INCLUDE: 
TIME FROM HirriWG A PREFIX KEY TIL 

PREFIX MENU IS DISPLAYED. 
DELAY AT A "FILE NAME?", ETC. QUESTION BEFORE 

DISPLAY OF QUESTION SPECIAL CHARACTERS MENU. 



02DZ 40 



DEL4: DB 64 ;CONTRQLS LONG DELAY: USES INCLUDE: 
TIME SIGNON REMAINS ON SCREEN. 
TIME "NEW FILE" MESSAGE REMAINS ON SCREEN. 
TIME "ABANDON" MESSAGE REMAINS DISPLAYED. 
TIME TO WAIT FOR FULL SCREEN REFRESH DURING 
HORIZONTAL SCROLLING 



0223 09 



DELS: DB 9 ;CONTROLS DELAY USED FOR A FULL SCREEN 
REDISPLAY HIRING HORIZONTAL SCROLLING. IT IS 
THE AMOUNT OF TIME TO WAIT AFTER A KEYSTROKE 
TO REFRESH TSE SCREEN. 



Appendix E 



USERl Listing 



USEBl 04/23/81 TERMINAL FAICH ABEA, MCRO-SO 3.13 



PAGE 15 



ITEMS FOR NON-STANDARD VERSIONS OF WORDSTAR. 
THESE ITEMS ADDED IN WORDSTAR 2.20. ****** 



02D4 00 



02D5 00 



02D6 00 



TRSCRS: DB 



TRSCIF: DB 



HEIHBS: DB 



02D7 00 
02D6 01 01 



AFLFLG: DB 



NMOFUS: DB 1,1 



02DA 00 



TCKFIiS: DB 



;USED ONLY IN TRS-80 jyiODEL 1 WORDSTAR, 

; INOPERATIVE IN NORMAL WORDSTAR. 

;SET OFFH TO USE SPECIAL CURSOR DRIVER. 

;USED ONLY FOR TRS-80 MODEL I WORDSTAR, 

; INOPERATIVE IN NORMAL WORDSTAR. 

;SET TO OFFH FOR SPECIAL I^EYBOARD DRIVERS 

;USED ONLY FOR HEAIH89 WI!ffl LIFEBQAT 
;CP/M 1.42 i 1.43. INOPERATIVE IN NORMAL 
;WORDSTAR. SET TO OFFH TO ALLOW WORDSTAR 
;T0 PATCH BIOS TO ELIVIATE BS, SPACE, BS 
;PROBLEM WHEN RDBOOT IS ENTERED 

;USED ONLY FOR TSE APPLE VERSION OF WORDSTAR 
•SET BY INSTALL, NO NEED FOR USERS TO CHANGE 

;'IHE # OF USERS ON THE SYSTEM. NORMALLY 1 
;SET TO A HIGHER VALUE IF WORDSTAR SPENDS 
;T0O MUCH TIME POLLING CSTAT, CAUSING TEE 
;SYSTEM TO SLOW DOWN. SHOULD ONLY BE USED 
;IF THE OPERATING SYSTm CAN BUFFER KEY- 
;BQARD CHARACTEELS. 

;SET TO OFFH IF UNDER MP/M & SYSTDf CALL 141 
;CAN BE USED FOR A DELAY. THE VAUEb OF DELI, 
;ETC. MAY HAVE TO BE CHANGED TO CORRESPOND 
;T0 THE AMOUNT OF TIME ALLOCATED PER TICK. 
;!miS SAVES CPU TIME IN A MUIZTIPROCESSING 
; ENVIRONMENT 



02DB 00 



02DC 01 



RSTFLG: DB ;SET TO NOIf-ZERO IF A DISK RESET SHOULD NEVER 
;BE ISSUED MANY VERSIONS OF MP/M DO NOT ALLOW 
;FOR DISK RESETS THIS WILL FIX THE MP/M ERROR 
;MESSAGE HAT MAY OCCUR 

DEFDSK: DB 1 ;THE DEFAULT DISK DRIVE TO TEST FOR WSMSGS, 
;WS0VLY1.0VR, ETC. IF THE NECCESARY FILE IS 
;N0T ON TSE LOGGED ON DISK DRIVE PRESENTLY 
;SET TO TEST TSE A: DRIVE. SET 2«B:, 3"C:, ETC. 



02DD 14 



SCRLSZ: DB 20 



;# OF SCREEN POSITIONS TO HORIZONTAL SCROLL 
;AT A TIME PRESENTLY SET TO 20, ADJUST IF YOU 
;WANT SCSEiZI TO SCROLL MORE OR FEWER SCSEEN 
;POSITIONS 
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DISCUSSION OF MEMDBY-MAPPED VIDEO BOARD INSTAT.TATION 



1. THE SIMPLEST INSTALLATION METHOD IS TO ACCESS THE BOARD 
THROUCT THE OPERATING SYSTEM, AS THOUGH IT WERE A TER- 
MINAL. THIS REQUIRES, OF COURSE, THAT CURSOR CAN BE 
POSITIONED BY OUTPUTTING A CHAR SEQUENCE. ONLY THOSE 
OPTIONAL FEATURES (LINE INSERT, ERASE END LINE, ETC.) 
THAT CAN BE INVOKED VIA CHAR SEQUENCES MAY BE USED. 

2. MEMAPV/M£MADR (SEE PAGE 8 OR SO): FOR BOARDS TEAT MEET 
THE RESTRICTIONS (SEE PAGE 8), THIS METHOD IS BEST FOR 
SPEED, MEMORY UTILIZATION, AND BECUASE ERASE TO WD 
LINE, LINE INSERT, AND LINE DELETE FUNCTIONS ARE 
IMPLICITLY AVAILABLE WITH NO INSTAT.TATION CONSIDERATION, 

3. BOARDS TEAT DO NOT MEET TEE MEMAPV/MEHADR RESTRICTIONS: 

A. ACCESS AS A TERMINAL IF PRACTICABI£ - Um 1 

B. BOARDS THAT CANNOT BE ACCESSED AS A TERMINAL (E.G. 
BECUASE CURSOR POSITIONING OR SOME DESIRED OPTIONAL 
FEATURE NOT ACCESSIBLE IHROUGH OPERATING SYSTEM) AND 
FOR WHICH MEMAPV/MEMADR CANNOT BE USED (E.G. BECAUSE 
HIGHLIGHTING IS DESIRED AND IT IS NOT INVOKED BY 
HIGH ORDER BIT OF CHARACTER, OR BECAUSE CHARACTER 
POSITIONS DO NOT APPEAR AT CONTIGUOUS INCREASING 
MEM3R7 ADDRESSES) : YOU MOST CODE YOUR CFUS DELIVER. 

SUGGESTIONS FOR CODING YOUR (Mf VIDEO BOARD IRIVER: 

BUILD THE DRIVER AROUND A CUSTOM CHARACTER QOTFUT 
SUBROUTINE ACCESSED VIA THE "UCONO" ITEM. THIS ROUTINE 
WILL RECEIVE THE ASCII CHARACTER CODES 20B-71E (WHICH IT 
MUST DISPLAY) , THE CONTROL CHARACTERS CARRIAGE RETURN AND 
LINE FEED, WHICH IT MUST PROPERLY INTERPRET, AND OTHER 
CONTROL CHARACTERS PER YOUR PATCHES IN THE CURSOR POSI- 
TIONING im/S AND OTHER TERMINAL ITEMS, AS USED. NOTE 
THAT UCONO RECEIVES ADDITIONAL USEFUL INFO IN BCDEHL. 

CURSOR POSITIONING MAY BE BY CHARACTER SEQUENCE (USE 
CURSOR PATCH ITEMS AS FOR A TERMINAL, PAGE 3, AND INTER- 
PRET THE CHAR SEQUENCE IN YOUR UCONO ROUTINE, OR BY 
CUSTOM SUBROUTINE (UCRPOS, PAGE 4. READ COMMENTS WITH 

wrm UCRPOS re useful info in registers CAREFULLI!). 

SEGHLKSTTING MAY BE INVOKED BY HIGH ORDER BIT ON 
EACH HILITED CHARACTER (HIBIV) OR BY CHAR SEQUENCES 
(IVGN AND IVOFF, AND INTERPRET THE CHARS IN UCONO). 

ERASE END LINE, LINE DELETE, AND LINE INSERT, IF IMP- 
LEMENTED, MUST BE INVOKED BY CHAR SEQUENCES PATCHED INTO 
ERAEOL, LINDEL, AND LININS AND INTERPRETED IN UCONO. 

INITIALIZATION MAY BE DONE VIA TRMINI OR INISUB. 
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02DB 00 00 



DB 0,0 ;SFAiCE RESERVED FOR EXPANSION 
SPACE FOR USER-ADDED SUBROUTINES 



MORPAT: 



0220 


UO 00 00 00 


02E4 


00 00 00 00 


02E8 


00 00 00 00 


02EC 


00 00 00 00 


02F0 


UO 00 00 00 


02F4 


00 00 00 00 


02F» 


uO 00 00 00 


02FC 


00 00 00 00 


03UO 


uO 00 00 00 


030^ 


00 00 00 00 


0308 


uO UO 00 00 


030C 


00 00 00 00 


03 iO 


uO UO 00 00 


03 U 


00 00 00 00 


0318 


UO UO 00 00 


03 IC 


00 00 00 00 


0320 


UO 00 00 00 


0324 


00 00 00 00 


0328 


00 00 00 00 


03ZC 


00 00 00 00 


0330 


UO 00 00 00 


0334 


00 00 00 00 


0338 


00 00 00 00 


033C 


00 00 00 00 


0340 


00 00 00 00 


0344 


00 00 00 00 


0348 


uO uO 00 00 


034C 


00 00 00 00 


0350 


UO 00 00 00 


03 D4 


00 00 00 00 


0358 


00 00 00 00 



DB 
DE 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DB 
DC 
DB 
DB 
DB 
DB 
DB 
DB 
DB 



0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0,0 
0.0 



;ADDmONAL SPACE HAT MAY 

;BE USED FOR USER PATCHES, 

;FOR EXAMPLE FOR A CURSOR 

;?0Sm0NIN6 SUBROUTINE, OR 

;FOR •*INISUB" OR "UNISUB" 

; SUBROUTINES. 

;FOR "JET MORE SPACE, 

; SPACE, SEE "PBGMEM", NEXT. 
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035C 0000* 



PROVISION FOR EXTENDED PATCHING 

;PBGMEM POIHTS TO BEGINNING OF WMOKZ TO USE FOR WORK- 
;ING STORAGE. IF YET MORE SPACE IS NEEDED FOR PATCHES, 
; INSTALL FIRST, THEN POT YOUR ADDED CODE WHERE PBGMEM 
;POINTS AND INCREASE PBGMEM TO POINT BEYOND YOUR PATCHES, 
;BE SURE TO USE A LARGE ENOUGH "SAVE" COMMAND I 
; — SAVE SIZE REQUIRED IS macfa LARGER THAN FOR WS.CQM 
;WnBOUT ADDED PATCHES! 



PBGMEM: JXf MEMORY 



;An indefinite amount of code nay 
;be added here AFTER INSTALLation. 

;Do Dot add code before INSTALLing, 

;as INSTALL will delete it I 



03^E 



; ** END TERMINAL MODIFICATION AREA ** 

ALABEL EQU $ ;ASSEMBLER SHOULD PRINT 35E 

END ;NErr MODULE LOADS AT LOCATION 360 HEX 
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Macros: 



Symbols 


• 
• 














&LABEL 


03:3E 


APLFLG 


02D7I 


ASCUR 


026UI 


CB4LFG 


025DI 


CLEADl 


024AI 


CLEAD2 


02531 


COLOFF 


025FI 


CEBLIV 


02B5I 


CTRAIL 


02581 


DEi'DSK 


02DCI 


DFT.l 


02CFI 


DEL2 


02D0I 


DEL3 


02D1I 


DEL4 


07D2I 


DEL5 


021)31 


DELCUS 


02AEI 


DELMIS 


07AFI 


ERAEOL 


026DI 


HETHRS 


02D6I 


HIBCDR 


02B4I 


fJIBIV 


02R3I 


HITE 


02481 


INISUB 


02A4I 


IVOFF 


028BI 


IVON 


02841 


LINDEL 


02741 


LININS 


027BI 


T.TNOFF 


025EI 


MEMADR 


02B1I 
02D8I 


MEMAPV 
ODTCHR 


02B0I 
02b7* 


MEMDHT 
PBGMEM 


035C* 
035CI 


MDRPAT 


02E0I 


NMDFDS 


KI;'1JIER 


02B9I 


BSTFLG 


02DBI 


KUBl'Xl!' 


02B8I 


SCRLSZ 


02DDI 


SWIN 


02C3I 


b'WOUT 


02C9I 


TBASE 


0100 


TCKFLG 


02TWI 


TRMHa 


02921 


IRMJNi 


029BI 


TRSCIF 


02D5I 


TESCRS 


02D4I 


UCNSTA 


02BAI 


[JCONI 


02BDI 


UCONO 


02C0I 


DCRPOS 


02641 


DNISUB 


02A7I 


[JSELST 


02AAI 


WID 


02491 


ZAFCIN 


02B6I 







Mo Fatal error(s) 
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Appendix F 
The Printer Patch Area (USBR4) 

A listing of the WordStar user-modifiable module USER4 follows this page- 
This assembly listing is supplied for the con7enience of the occasional user 
who may need to install WordStar for an unusual terminal or printer. Note that 
this listing is for the standard TBftSE=100 Hex version. For the TRS-80 Model I 
version, and the Heath 89 version origined at 4300 Hex, add 4200 Hex to all 
addresses shown in listings. For a discussion of this listing, see Sections 6- 
8. 

A separate publication, Worr^Sfrj^r Cuatomizatlon liotsS/ is directed towards OEM's 
and system programmers. The Customization Notes contain additional source 
listings, including: 

o default areas 

o message files 

o OEM daisy wheel and similiar printer drivers. 
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TIILE nSEB4 04/10/81 PRINTZS PATCH AREA 



; FOR ifordStar REIEASE 3.0 M;» 1981 



rmfi IN IHIS FILE ARE NOI&iALLT SET AS KEQUIRED BY THE 
UTSTAT.T. HIOGRAH, OR USED WITHCCT CHANGE. 

TFTRRK IS N0BMALL7 NO NE£D TO B£FER ID lEIS LISTING IN 
ORJER 10 MAKE WORDSTAR OPERATIONAL, AS THE INSTALL 
PROGRAM WILL SET ESSENTIAL ITE2S AS REQUIRED 
FOR ALL NORMAL 1HSTALIATIC»IS. 

MDDIFICATIDNS SCME USERS MAT WISH TO MAKE IS ITHB 
LISTED HERE INCLUDE: 

1. ADDING CONTRCL SEQUENCES FOR A TELETYPE-LIKE (NDN- 
DAIS7) PRUrrER TO SUPPORT ADDITIOKAL EEATDRES, E.G. 

CHARACTER PITCH CHANGE 

RIBBON COLOR CHANGE 

PARTIAL LINE MOTION (FOR SUBSCRIFIS) . 

2. M3DIF7ING OR ADDING TO THE DRIVER CODE USES TO 
SEND CHARACTERS TO AND ERCM ISE PRINTER, FOR TBE 
FOLLOWING OR OTHER REASONS, IN CASES WHERE 
\X)RDSrAR*S PORT DRIVER (WHIGH CAN BE FULL? SET UP 
BT ANSWERING INSTALL* S QUESTIONS) CANNOT BE USED. 

A) ALLOW RECEIVING CHARACTERS WOtL PRINTER, 
FOR PRINTERS WHICH REQUIRE E!!Z/ACK 
IBOTOCOL TO OPERATE AT MAZDfJM BAUD RATE; 

B) ALLOW WORDSTAR TO DETERMINE IF PRINTQL IS 
READY TO RECEIVE A CHARACTER, FOR BETTER 
PERFORM^CE IN CONCURRBIT PRINTING; 

C) INSTALLING A CUSTCM DRIVER FGR PRINTER NOT 
SUPPORTED BY USER'S OPERATING SYSTBf NOR 
SUPPORIABIE WITH WORDSTAR'S PORT DRIVER. 
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;SEIS PAGE LENGTH 
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0000' 

• ENTRIES 

ESTSZ P0SMIH,BLI3STR,I2BL5TR,PSCgLF,PSCa,PSHAIg,PBACKS 
ENTBX FALT,PSTD,RGLDP,RG!LDOW, RIBBON,RIBOFF 
WIS! nSBl,US52,nSB3,USB4 

mna psinit,psfini, sochr,ulcb£ 

OTEBY PRIHITjPBFINI, CSWrca,BAVBSY 

EKTBY LTBSY,LISEND,LISINP, PQBSY,POSEND,POINP 

EMIBY POSTAT,P0MASK,PO(M,P0GP,POINSK,POIM,PISTAI,POIP 

mna pubs7,poseziid,puiiip 

KETIKX ACBSY,ACSniD,ACIliIF,AC?IN,ACSTAl,ACSTAR,001!IFIE 
BXnSY HbOTCLfEAKBSZ 

; EQUATES 

0100 ISASE BQU lOOH ;UHEBE HLOGBAM IS LQASED FOR mmAL CF/H 

0000' A5ES U^CUjm CODE, FOR USER LZSII136 

OBG 73ASE+590H ;BE6INS AFTER WD OF nSEB3 

0003 IQB7EE BQIJ TBASE-100fif3 jLOCAIION OF STTQl I/O 

;ASSIQ1MESTS SIAHJS BITE, USED BY 
'AT.TKJJWATH! GDNSCIZ PRINTER DRIVER. 

0005 BDOS BQU TBiUSE-lOOQfS iBDOS STSTQI CALL QTISY POINI, 

;IJSED IN CP/M LIST DEVICE PRINTER DRIVER. 

0005 LISTF BQU 5 ;CP/M LIST ODTPDT SYSTIM CALL iTOCTION #, 

;USED B7 CP/H LIST DEVICE PRUiTQL DRIVER. 

0008 BS Eq(7 8 ;BACKSBACE CHARACTER 

OOQA LF BQU 10 iUM FEED 

OOOC FF OqU 12 ;F0BM FEED 

OOQD CR BQU 13 ;CARRIAGE RETDRN 

007F DEL BQU 7FH ;DEI£TE OR BDBOUT 
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nS£B4 04/10/81 PRSTEEa PATCH ABSk 
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0690 01 



;IT£MS BELAUNG TO ALL FRUmSS 
FRINTZR CHABACTERISTICS AND HQNTING MEISOO 



PRmnS TYPE / OVERSTHIKE METHOD **** TEE! 
IMPORTANT: EETERMINES METHOD OF DOUBLE 
STRIKE, UNDERLINE, ETC, AND ^HE'IHKR DAIST- 
LIKE PRINTER CAPABIZ OF MICROSPACE JUSTIF7. 

POSMIH-FF HEX: 

PRINTER CAN 07ERPRINT 0NL7 B7 CARRIAGE 
RETURN WTEHODT LINE FEED. 

POSfflH-0: 

PRINTER CAN OVERPRINT B7 BACKSPACING AS 
WELL AS BY CARRIAGE RETURNING. 
NOTE: Wrm P0SMIH»O, CR-OVERPRINT IS USH) 
ONLY FOR OVERPRINT LINES IN FILE, FOR 
PRINTEELS IHAT CAN BACKSPACE BUT NOT RETORN 
CARRIAGE WITHOUT LINE FEED (EG SELECTRIC) , 
USE POSmS-O AND ISN'T USE OVERPRINT LINES. 

POSMm-1: 

PRINTZK IS A DAISY WHEEL OR SIHILAR II7CSS- 
MQHAL PRINTER. CAN PRINT WTTBGUT SPACING; 
CAN SPACE AND ROLL IN SfALL INCREMENTS. 
MICRaJUSTIilCATiaf OCCURS ONLY IF POSMIH-1. 
ADDITIONAL PATCH ITQS IN USER5.HAC ARE SET 
BY THE INSTALL VBXXSAA FOR DAISIES. 



POSMTH: DB IH 

;FF SEND CS. THEN ANOTHER WHOLE LINE 

;00 SEND BACKSPACE THEN CHAR TO 

; PRINT OVER LAST CHAR SENT 

;01 DIASY WHEEL PRINTER WITH ALL NECESS 

: ITQS IN USEB4 AND USEE15 INSTALIZD. 



0691 02 

0692 02 

0693 00 00 00 



BLDSTR: DB 2 ;NUMBER OF STRIKES FOR "BOLDFACE*' 
;SET 3, 4, 5, ETC FOR DARKER "BOLDFACE" 
;C K NOR- IAISY PRINTER. FOR DIASY 
;PRINTERS, 2 IS USED - DON'T CHANGE. 

DBISTR: DB 2 ;NUHBER OF STRIKES FOR "DOUBLE 
;STRIKE". INCREASE AS DESIRED. 

DB 0,0,0 ;R£SEEVED 
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; irkrHticMt USER-PATCHABUE FDiaCTlDN 

; STRINGS FOR NOI^-I^ISY PRINTERS ******** 

;EAC& STRING CONSISTS OF THE NDMBER OF ffSTES, 
;FGLLOWED B7 1BE BYTES TO BE S£2IT. 
;IF JUNCTION IS NOT AVAILABLE, 
;NDHBER OF BYTES SHODLD BE ZIEO. 

; IT£2S GN NE2T N PAGES APPLY ONLY WIM 
; POSMm (ABOVE) IS OR FF, NOT 1. 



0696 


02 


0697 


QD 


0698 


QA 


0699 


00 00 00 00 


069D 


00 00 00 00 



06A1 



06A2 
06A3 
06A4 



02 



OD 
00 
00 00 00 00 



STRING TO ADVANCE TO NEST LINE, USED JHHES 
CR,LF ENCCONTBLED IN FILE. 

IF YOUR PRINTIS REQUIRES NULLS SENT 
AFTER CARRIAGE RETURN (FOR DEL^) , 
INCREASE COUNT SO SCHE OF 
FGLLOtmC ZEROES ARE SENT. 

IF YOUR PRINTER ADTO LINE-FEEDS AFTER 
CR CODE, RUffiVE LF. (IF POSSIBLE, 
TORN OFF AUTO-I^ IN YOOR PRINTER 
INSTEAD, FOR GBEATER FLEZIBILY OF 
WORDSTAR USE). 

PSCSLF: DB 2 ;NDMB£R OF CHARACTERS 
DB CR ;1ST CHAR: CARR RET 
IB LF ;2ND CHAR: LINE FEED 
DB 0,0,0,0 ;S£ACE FOR 8 
DB 0,0,0,0 ;..H}RE CHARS 

STRING TO RETURN CARRIAGE TO BEGINNING 
OF SAME LINE, TO OVERPRINT. 

USED FOR UNDERLINE, DOUBLE STRIKE, ETC IF 

POSMIH (ABOVE) IS FF. 
;AND WHE7 CR WIISOOT LF IS MCOUNTERH) 

IN FIXE IF POSMm IS FF OR 0. 
;ALSO USED WHEN POSmS IS FF AND BACKSPACE 

(•H) IS ENCOUNTERED IN FILE. 



PSCR: DB 2 



DB CR 
DB 



;2 CHARS: CR AND A NULL, 
;T0 ALLCW A LUTIZ TIME 
;FOR CERTAIN PRINTERS. 
;CARRIAGE RETURN 
;NUII., FOR DELAY 



DB 0,0,0,0 



; SPACE FOR 4 
;H}RE CHARS. 
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;N0If-DA.IS7 STRINGS. • • 

STRING TO DO CARRIAGE RETOBK MD HALF LINE 
FEED, FOR PRUTTEBS THAT CAN DO HALF LINE FEED 
DOWNWARD BUT HOT UIWABD. USED TO PRINT 
SUBSCRIPTS AND SUPERSCRIPTS AT HALF-LINE 
INTERVALS IF RaUP (BELOW) NOT INSTALLED 
AND POSMIH IS FF OR 0. 

FOR FZAMPLE, FOR A SELECTRIC THAT ALIJAZS 
FEEDS HALF LINES, INSTALL ONE CRLF HERE, 
TWO IN "PSCRLF** ABOVE. 



06A8 


CO 


PSHAT.F: DB 


06A9 


GO 00 00 00 


DB 0,0,0,0,0,0 


Of)AD 


00 00 





STRING TO BACKSPACE, IE TO OVERPRINT LAST 
CHAR PRINTED. 

USED FOR UNDERLINE, DOUBLE STRIKE, ETC IF 
POSMm (ABOVE) IS 0. ALSO USED WHEN BACKSPACE 
(og) ENCOUNTERED IN FILE IF POStOE IS 0. 



06AF 01 
06B0 08 
06B1 00 00 00 00 



PBACKS: DB 1 
DB BS 
DB 0,0,0,0 



;ASCII BACKSPACE 
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06fi5 00 

06E6 00 00 00 00 



06BA 00 00 00 00 
06BE 00 



06BF 
06C3 



06C4 
06C8 



00 00 00 00 
00 



00 00 00 00 
00 



;N0R-DAIS7 STBHilGS... 

**** THE FOLLCWI NG ARE OPTIONAL 

STRINGS, FEEHITTING USE OF ADDITION&L 
5EATDRES IF SDPPORTED BY YCDR PRINTER, 

STRING TO SET ALTERNATE GHABACTER 
WIDTH, IF AVAILABLE, 



PALT: DB ;0 CHARS: NOT AVAILABLE 
DB 0,0,0,0 

STRING TO BESET TO STANDARD CHARACTER WIDIH 

PSTD: DB 0,0,0,0,0 



STRING TO BOLL CARRIAGE UP A PARTIAL LINE 
WITHCIUT ALTERUG CABRIAGE CQLDMN, 
IF AVAILABLE, FOR USE BEFORE SUPERSCRIPT 
AND AFTER SUBSCRIPT. RQLDOW SHOULD ALSO 
BE INSTALLED TO RCLL CARRIAGE SAME AMOUNT 
IN OTHER DIRECIia?. APPLIES IF POSMm-FF OR 0. 



ROUP: DB 0,0,0,0,0 



SISING TO BOLL DOWN, AS AFT£S SUPERSCRIPT, 
IF AVAILABLE. USED ONLY IF RQLUP ALSO 
INSTALIED. 



RGLDCRT: DB 0,0,0,0,0 



; ****** USER-PAICHABIE TTEHS FOR BOTH 
; BOTH DAIST AND WSM^JSI PRINTERS 



* * ******* 



STRINGS FOR USER-DEFINED H7NCTI0NS 1-4, INVOKABIE 

wuh print conieol charactebs imbedded in file. 

USE 0NL7 WUH ESEREME CAUTION AND VERY IHORaiGH 
TESTING ON Q&ISY PRIHTERS, AS WORDSTAR'S CONIROL 
SEQUENCES AND YOURS COULD EASILY INTERFERE. 

LINES CONTAINING CONIROI^ THAT INVOKE THESE 
ALmYS PRINT FOBWABD EVEN IF BIDIRECTION PRINT IS ON. 



06C9 


00 


USRl: 


DB 


06CA 


00 00 00 00 




DB 0,0,0,0 


06CE 


00 


USR2: 


DB 


06CF 


00 00 00 00 




DB 0,0,0,0 


06D3 


00 


USR3: 


DB 


06D4 


00 00 00 00 




DB 0,0,0,0 


06D6 


00 


USR4: 


DB 


06D9 


00 00 00 00 




IS 0,0,0,0 
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;I1^IS7 / N0N-DAIS7 ITEZfi... 



06DD 


00 R 


06IX: 


00 00 00 00 


06E2 


00 R 


06E3 


00 00 00 00 



06E7 


01 


06E8 


OD 


06E9 


00 00 00 


06EC 


00 00 00 00 


06F0 


00 00 00 00 


06F4 


00 00 00 00 



06F8 


00 


06F9 


00 00 00 00 


06FD 


00 00 00 00 


0701 


00 00 00 00 


0705 


00 00 00 00 



ismms USED by Bcm diasies md nob-daisies. 

;ADT0H&nCALL7 FATCHED FOR DAISIES B7 INSTALL FR06RAM; 
;MEDOLB Wrm CAUTION FOR DI^IS7 FRINTERS. 

CHANGE RIBBON COLOR (OFTIONAL) 

RIBBON: DB ;CHANGE TO ALTERNATE COLOR 
DB 0,0,0,0 

RIBOFF: OB ;CHANGE BACK TO BLACK 
DB 0,0,0,0 

STRING TO INITIALIZE PRINTER. SENT AT 
START OF FRINTING, M7 BE USED TO TORN MDTOR 
ON, SET STANDARD CSARACTER SIZE AND LINE 
HEIGHT, OR OTHER FDNCTIGNS FOR 70CIR SFECITIC 
HARIWARE. ALWIS FATCHED B7 INSTALL FROGRAM, 
ADD YOUR BYTES AFTER INSTALLATION. 



FSINIT: DB 1 
DB GR 



;Nl]MBER OF G3ARACTERS 
;CARRIAGE RETURN, TO HAKE SDRE 
;CARRIiGE STARTS AT LEBT EDGE 
;0F FAFER. 

DB 0,0,0 

DB 0,0,0,0 ;0F TO 16 CHARACTERS .. 

DB 0,0,0,0 ;.. TOTAL TO SEND .. 

DB 0,0,0,0 ;•• TO PRINTER 

STRING SENT TO PRINTER AT OONCLnSION OF 
PRINTING, EG TO TORN MDTCS. OFF. 



FSFINI: 



0709 00 00 



DB 

DB 0,0,0,0 
DB 0,0,0,0 
DB 0,0,0,0 
DB 0,0,0,0 

IX 0,0 



;UF TO 16 CHARS 
;fiESER7ED 



070B 2D 



; CHARACTER USED FOR "STRIKEGOT" PRINT ENHANCEMENT 
; (INVOKED WHE CONTRQL-X PRINT CONTROL) 
SOCHR: DB •-* 



070C 5F 



; CHARACTER USED FOR "tTNDERSCORE" PRINT ENHANCEMENT 
; (INVOKED WITH CQNIRQL-S PRINT CONTROL) 
ULCBR: DB ' * 



Appendix F 



nSER4 Listing 



USEEVf 04/10/81 FRUITER PATCH AREA 



HACRO-dO 3.13 PAGE 8 



070D 00 
070E 00 
070F C9 



CUSTOM TBJMEBi UriTIALIZE SDBR, C&LIED BEFORE 
STRBC (PSDHT OR DINIT) IS SENT. USE FOR 
ASrmWG TBAT CAS*T BE ACOOMFLISSED WITH 
A STRBIG, SUCH AS ^SIGNMENT GR INITIALIZIIG 
A SPECIAL IKIVER INSTALLED IN YOUR BIOS. 

IRINIT: NOP 'ylNITTALLT NULL. PATCH A JMP 

NOP ;T0 TOUR ROUTINE HERE. Sl^ END 

RET ;QF USER1.K&C RE FINDING PATCH 

;SPACE. 

CUSTOM PRINTM FINISH (CLOSE) SUBR» CAT.TflD 
AFTER SISHX; (PSFINI OR DFINX) IS SENT. 



0710 


00 


PRFINI: NOP 




0711 


00 


NOP 




0712 


C9 


RET 




0713 


00 00 00 00 


DB 0,0,0,0 


^RESERVED 
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; ***** JLAGS RELATING TO IBANaHSSION 
; CF CHARACTERS TO PRIMTER ***** 



;m2S ON lEIS PAGE RELATE TO ALL PRlNTJiRS. 



0717 03 



CSWTCE: DB 3 ;WHERE TO SEND EACS OQTPUT CHARACTER: 

00 TO CP/M LIST DEVICE. 
HAVBSY SHOULD BE (UNLESS YOU 
INSTALL A "BUSY" RCOTIHE AT LIBSY) 

01 TO nrSTALL-PROGSAM-PATCHABIZ PORT DRI7ER 

02 TO USER SUBRCDTINE, ENTRY POINTS 
PDBOSY, PUSEND, AND HJIHP. 

03 TO OIM DAISY HtlHTER DRIVEEU FORCES POSMIH-1. 

04 TO AITERNATE OONSCIE PRINTER DRIVER. 



0718 



FF 



HAVBSY: DB OFIH ;NON-ZER0 IF PRINTER DRIVER 
; AS mSTAIXED AND PATCHED 
HAS A "BUSY" TEST SEPARATE FRGM 
"FRINi: A CHARACTER". IF NON-ZERO, 
CONCnRR£IIT EDITING AND HLINTING 
WILL PERFORM BETTER; MOST BE ZERO 
IF CAN'T FIND OUT ^HE 'I HEK PRINTED 
IS BUSY (AS MIBES CHARACTERS ARE 
OOTPDT IHRCDGa CP/M "LIST" DEVICE), 



0719 00 



DB ;RESERVED FOR E2PANSI0N 



Appendix F 



nS£a4 Listing 



nSEB4 04/10/81 FRSTEER PATCH AREA 



MACRO-80 3.13 PAGE 



10 



***** HLHITER DRIVERS PER SE ***** 

IBERE ME FIVE DRIVERS, CORRESPONDINS TO 
CSWTCa (PREVIODS PAGE) - 00, 01, 02, 03, 04. 

EACH OF ISE DRIVERS HAS IBREE ENTRIES: 

1. BUSY STAIDS ENTBY. SEIDRNS CY»1 IF 

PRINTER IS NOT READY. IF UUIMELEMENTED, 
RETURN CY'^. HAVBSY SHOULD BE IF 
UHIMPLIWENTED AND FF IF IMBLEMENTID. 

2. SEND CHARACTER (A REGISTER) ENTRY. 

3. INPUT A CHAR TD A, OR RETDRN CY*1 IF NO 

INPUT CHARACTER READY. THIS ENTRY IS 
USED ONLY FOR E3Z/ACK AND XON/IDFF 
BUFFER BULL PROTOCOLS IMPLEMENTED 
WITHIN EDITOR (SEE '*PR0TCL" BELOW). 

THESE RCCTINES MY CLOBBER ALL REGISTERS. 



PRINTER DRIVER TO OUTPUT TO CP/M LIST 
DEVICE. ONLY CALLED IF CSWITCH-00. 



UBSY: ;BUSY TEST ENTRY - BUSY TEST MAY BE 
;ADDED HERE IF YOUR QPRRATDC SYSTEM 
;ALLOWS DETERMINING WEUUER PRINTER 
;JS READY. PATCH HAVBSY TO FF IF USED, 



07U 


00 


071B 


B7 


071C 


C9 



NOP 

ORA A 
RET 



;REIURN OO TO SAY 
; .. NOT BUSY. 



LISEND: ;OUTPUT CHARACTER (A) TO LIST DEVICE 



07 ID 


5P 


07 IE 


OE 05 


0720 


CD 0005 


0723 


B7 


0724 


C9 



mV E,A ;CHARACTER IN E FOR CP/M 

MVI C,LISTF ;£UNCTION # IN C 

CALL BDOS ;CALL SYSTEM 

ORA A ;CLEAR CY FLAG 

RET ;RETURN TO CALLER 



LISINP: ; INPUT CHARACTER TO (A) OR RETURN CY-1 

;IF NONE. THIS FUNCTION IS NOT SUPPLIED 
;BY OPERATING SYSTEM, USER MUST SUPPLY 
; SUBROUTINE IF ETX/ACR OR ZDN/XGFF 
;PROT0GOL IS TO BE USED. 



0725 00 

0726 37 

0727 C9 



NOP 

SIC 

RET 



;IF NO ROUTINE INSTALIZD, SAY 
: • . NO CHARACTER READY. 
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0728 


DB 


0729 


05 


072A 


00 


072B 


BS 


072C 


01 


072D 


EE 


072E 


01 


072F 


37 


0730 


CO 


0731 


B7 


0732 


C9 


0733 


D3 


0734 


04 


0735 


00 


0736 


09 


0737 


DB 


0738 


05 


0739 


00 


073A 


E6 


073B 


02 


073C 


EE 


073D 


02 


073E 


37 


073P 


CO 


0740 


IB 


0741 


04 


0742 


00 


0743 


B7 


0744 


C9 



; FBHTTER DRIVERS. . • 
FORT DRIVER. C&LI£D ORLT IF CSWITCH-1. 

DOES I/O DIRECT TO H&SDMARE FORTS. FORT MDMBERS MD 
STATQS BITS MA.Y BE SET AS DESIRED BY ANSWERUB QUESTIONS 
ASKED BY IHE INSTALL FRCGBAM AFTER CHOOSING "FOBT DRIVER", 

INITIALLY SET DP TO USE PORT 4 FOR DATA, FORT 5 BIT 
ON TO INDICATE READY FOR CDTFUT, PORT 5 BIT 1 ON TO 
INDICATE INFUT CHARACTER BEADY. 

SELECTING FOfiT DRIVER IN INSTALL SETS HAVBSY TO FF. 



F0BS7: ;FOBT DRIVER STATQS ENTRY 
;BDSY TEST CODE: 
DB (IN) ;"IN" mSTRDdlON 

POSTAT: DB 5 ;FATCH OUTPUT STATDS POET # HERE 
NOP ; - PORT 5 SHOWN AS EXAMPLE 
DB (ANI) ;MASK BIT(S) OF INTEREST - 

FCMASK: DB 1 ; BIT SECXm AS E2AMFLE. 

DB (XRI) ;C0MFL£2iENT BITS MICH H7ST 

POOM: DB 1 ; BE 1 FOR PRINTER READY. 
;IKM HAVE NON-ZERO IF PRINTER NOT BDY 
STC ;SAY NOT READY 
BNZ ;R£IURN IF NOT BEADY 
ORA A ;CI£AR GARRY: SAY READY 
BET ;R£IURN 

POSEND: ;PORT DRIVER SEND CHAR ENTEOT 

DB (OCT) 
POOP: DB 4 ;OUTFDT DATA POST PATCHED HEBE - 

NOP ; PORT 4 SHOWN AS EXAMPLE. 

BET 



POINP: 



PISTAT: 



POINSK: 



DB (IN) 
DB 5 
NOP 

DB (ANI) 
DB 2 
DB (2RI) 
DB 2 



;PORT DRIVER INPUT CHAR ENTRY, 
;USED IF iSOTCL-1 OR 2 ONLY. 

;PATCH INPUT STATUS PORT # HERE 



;MASK BITS OF INTEREST - Bl SHCWN 
;C0MFL£21ENT BITS IHAT ARE ON ^JHEN 
POIM: DB 2 ; INPUT CHABACTER IS READY 

;NCW HAVE TXL IF INPUT CHARACTER NOT READY 
STC 

BfiZ ;RE]URN C?"l IF NO CHAR READY 
;GHABACTER IS READY, INPUT IT 

DB (IN) 

POIP: DB 4 ;FATCH INPUT DATA FOBT # HERE 

NOP 

ORA A ; a.EAR C Y 

BET ;RETURN WHS CHAR IN A 
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0745 
0749 



07AC 



074D 
074E 

074F 
0750 
0751 

0752 



0753 
0754 



00 00 00 00 
00 00 00 



00 



B7 
C9 

00 
00 
C9 

00 



37 
C9 



;PRIinER DRIVERS. • • 
DB 0,0,0,0,0,0,0 



;RESERVED 



USER-SUPPLIABLE PRINTER ODTPDT SDBRCDTIHES 
CALLED ONLY IF CSWITCH-2. 

THIS M^ BE USED WHERE SPECIAL INTERFACE 
REQUIREMENTS NECESSITATE A MDRE CCMPLEX 
ROUTINE THAN THE PORT DRIVER ABOVE. 

SPACE IS PROVIDED HERE ONLY H)R IBE JHPS TO 
THE ROUTINES; PATCH OVER DRIVERS ABOVE, OR 
IN "MORPAT" AREA AT END OF USERl MDDUIE 
(SEE PRECEDING LISTING), FOR MORE SPACE, 
SEE "PBGMEN" AND ASSOCIATED COMMENTS AT 
END OF USERl LISTING. 



HJBSY: NOP 



ORA A 
BET 

PUSEND: NOP 
19QP 
RET 

^tJISF: NOP 



STC 
RET 



;ENTRY POINT TO USER-SUPPLIED 
; ROUTINE TO RETURN CY»1 IF 
; PRINTZS IS NOT BEADY. 
;IF UNIUPIEMESTED, RET CYH). 



;£ir£B3r POINT TO USER-SUPPLIED 
; ROUTINE 10 HUNT CHARACTER 
; IN A REGISTER. 

ENTSZ POINT TO USER-SUPPLIED 
ROUTINE TO INPUT CHARACTER, 
OR RETDIRN CY^l IF NONE READY. 
USED ONLY IF HtOTCL IS 1 OR 2. 

IF UNIMPIZMENTED, SAY NO CHAR RDY. 



0755 



00 00 00 



; THE PRINTER DRIVER FOR CSf9TCH«3 IS NOT IN USER4« 
DB 0,0,0 ;RESERVED 



Appendix F 



irSER4 Listing 



nSZB4 04/10/81 mmrSEL patch ^BEA MACEU>-80 3.13 PAGE 13 



;FRINT£R DELIVERS. •• 

"ALTISNATE OONSaLE** PRUITER DRIVER 
CALLED OSLZ IF CSWTCH-4. 

THIS DRIVER ALLOWS ACCESS TO HLIBTMS KU^UIRBIG 
CHABACTER DIFDT (FOR A CGMMDimC^ICNS IROTOCOL) 
WrmOTT EATCHIIIG IN A DRIVER, UNDER OPERATING 
SYSTEMS \miCB. SDFFOBI MDIJIPLE CONSOLES SELECTED 
VIA THE "lOBTTE" I/O ASSIGNMEI!nS BTTE. 

THIS DRIVER IS SELECTBD B7 SETTING CSWTCH TO 4. 

THE SPECIFIC CONSOLE DEVICE TO BE USED IS SELECTS) 
BY SETTING ITEM "CONFIE" BELOW TO 00, 01, 02, OR 03. 

'*HAVBSY*' SHOJIJ) BE WHEN USING ALTISNATE CONSOLE 
DRIVER, UNLESS YOU ADD A BUSY TEST ROUTINE. 



0758 00 

0759 B7 
075A O 



ACBSY: ;ENTSY POINT FOR CDHJT BUSY TEST. 

;N0 ROUTINE SUPPLIED, AS NORMAL OPERATING SYSTEM 

; DOES NOT IRUVIDE CONSOLE OUTPUT BUSY iUNCTION. 

NOP 

OBA A ;RK11IUN CY-0 TO SAY '*NOT BUSY" 

BET 



075B CD 0777 
075E CD 0000* 
0761 C3 076E 



ACSEND: ;£N1SY POINT TO SEIilD CHARACTER IN A TO PRINTER 

CAIL ACSTAR ;SET IQBYTE TO AUERNATE CONSOIZ, 
;SAVING ORIGINAL lOBITE IN B. 

CALL COUGH# ;O0TFUT CHARACTER (A) TO CONSOIZ, 
;PR£SERVING REGISTERS. 

JMP ACFIN ;G0 RESTORE IQBYTE AND RETDBN. 



ACINP: ;ENTBY POINT TO BETDRN CONSOLE INHTT CHARACTER 
•IN A REGISTER, OR RETURN CY«1 IF NO CHAR READY. 



0764 


CD 0777 


0767 


CD 0000* 


076A 


C4 0000* 


076D 


57 



CAZX ACSTAR ;SAVE AND SET IQBYTE 

CALL CONSI^^ ;IHIS SUBROUTINE RETURNS IN 

;A AND Z FLAG SET IF NO CHARACTER 
•IS READY AT CONSOLE. SAVES BCIEHL. 
CNZ INCHS^ ;IF CHARACTER READY, GET IT TO A. 

;£LSE IS IZET IN A. 
MOV D,A ;PDT VALUE TO RETDRN IN D FOR NOW 
;FALL THRU TO ACFIN ON NE2T PAGE TO RESTORE IDBYTE, 
;RETURN D IN A, CY"1 IF NO CHAR READY, ELSE CY"0. 



Appendix F nSER4 Listing 

nszs4 04/10/81 musens, patch area macro-80 3.13 page 14 

jPRHTEER DRIVERS. •• ALTERNATE CONSOLE DRIVER* •• 

ACFIH: ;A1JERIIATE CONSOLE DRIVHL COIMCN EUT ROOTINE 

076E 78 IDV A,B ;ORIGINAL lOBYTE, SAVED BY "ACSTAR" 

ACSTAl: ; "ACSTAR" SUBROUTINE JOINS HIRE 

07 6F 32 0003 SIA IDBYTE ;SET NEW lOBTTE OR RESTORE ORIGINAL 

0772 7A MDV A,D ;REST0RE A REGISTER 

;RETDRN CP«1 IF A«0: THIS IS NEHDED AT EXIT FRCM 
;"ACINP" ROUTINE, DOES NO HAIM IN OTHER CASES. 

0773 B7 ORA A ;TEST FOR NON-ZERO, CLEAR CY FLAG 

0774 CO RNZ ;IF NON-ZERO, RETURN C7 FLAG CIEAR 

0775 37 STC ;ELSE SET CARRY FLAG 

0776 C9 RET ;POR A-0 RETURN CY»1 

ACSTAR: ;CGUMON HnXY SUBR FOR ALTERNATE CONSOLE DELIVER 

MOV D,A ;SAVE A IN D, FOR ACSEND. 
IHA IDBYTE ;GET I/O ASSI(291ENTS STATUS BYTE 
W7 ByA ;SAVE INITIAL IQBYTE IN B 
ANI OFCa ;ZERO IHE "CONSOLE" PART OF lOBYTE 
DB (ORI) ;SET DESIRED CCNSOLB BITS 
CONFIE: DB 01 ;USER OR INSTALIATIDN SETS DESIRS) 
;CQ19S0LE BITS HERE: 

00 - TTY: PHYSICAL DEVICE 

01 " CST: roYSICAL DEVICE 

02 * BAT: PHYSICAL DEVICZ 

03 « UCl: PHYSICAL DEVICE 
; NEW IQBYTE VALUE IS NCW IN A 

0780 C3 076F J1!P ACSXAl ;G0 SET IDBYTE FRCM A, RESTORE A 

lIELCti D, AND RETDRN TO CALLER. 



0777 


57 


0778 


3A0003 


077B 


47 


077C 


E6 FC 


077E 


F6 


077F 


01 



Appendix F 



USER4 Listing 



USEB4 04/10/81 FRUITER PATCH ^REA 



M^aiO-80 3.13 PAGE 15 



0783 00 00 00 



0786 00 



DB 0,0,0 ;RESEB7ED 

**** PRINTER COMMJiaCATIDNS PROTOCOL **** 

APPLICABIE IF C5WTCH«0, 1, OR 2. 
APPLICABUS FOR MX POSMTH VMUES. 

THREE BUFFER iTJLL PROTOCOLS ARE SDPPOBTED: 

HO PROTOCOL: (PROTCL-0) : NO PROTOCAL EJCECUTH) IN WORD- 
STAR: USE IF NONE REQUIRED OR IF HANDLED ELSEHHERE, 
BS IN OPERATING SYSTQf OR IN USER DRIVER BUITINES. 

ETX/ACK PROTOCOL (PROTCL-1) : WS TRANSMITS "KK*' AT END 
OF STRING OF CHARACTERS, PRINTER RESPONDS WITH 
"ACK" WHEN ALL OF IHESE CHARACTERS HAVE BEM 
PRINTED. DELIVER MOST BE ABIE TO INPUT CHARACTERS. 

XDN/IDFF PROTOCAL (PROTCL-2): PRINTHL 

SENDS "laFF" WHEN WS SHOULD STOP SENDING, 
"SON** WHEN TRANSMISSION SHOULD BE RESUMED. 
DRIVER H7ST BE ABIE TO INPUT CHARACTERS. 



ISOTCL: DB ;0-N0 PEONTQl BUFFER FUU. PROTOCOL 

;1"«1Z/ACK HtOTOCOL. SET EAKBSZ BELOIf! 
;2-XDN/2DFF HtOTOCOL 
USE FOR MOST TT7-LIKE PRINTERS AND FOR SERIAL 
DAISY IRINTERS INTERFACED AT 300 BADD OR SLOWER. 
FOR DIABLO AND QUMB AT 1200 BADD, USE 1. 
FOR NEC AT 1200 BAUD, USE 1 OR 2 AND CONFIGURE IHE 
PRINTER APPROPRIATELY, OR USE & CABLE ADAPTER. 



0787 7F 



EAKBSZ: DB 127 ;E1Z/ACK MESSAGE LENGIE (1/2 PRINTER'S 

;BUF5ER SIZE), APPLICABLE ONLY IF PRDTCL-1, 
;ADTGHAIICALLY PATCHED FOR DAISY PRINTQIS. 



0788 
078A 

078E 



00 00 

00 00 00 00 



DB 0,0 

DB 0,0,0,0 



ALABEL EQ[7 
END 



$ 



;RESEEVQ) FOR EXPANSION 
;fiESERVED FOR OSANSION 

^ASSEMBLER SHGUU) PRINT 78E 

;NESr MODUIE LOADS AT 790H 
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Macros: 



STinbols 


• 
• 














ACBS7 


07581 


ACFUil 


076EI 


ACINP 


07641 


ACHEND 


.075BI 


ACSTAl 


076FI 


ACSTAR 


07771 


ALABEL 


078E 


BDOS 


0005 


BIJ3SIR 


06911 


BS 


0008 


CONFIE 


077FI 


OONSTA 


0768* 


COUCH 


075F* 


ca 


OOQD 


CSWTCH 


07171 


DBLSIE 


06921 


DEL 


007F 


EAKBSZ 


07871 


FP 


OOOC 


HAVBSY 


07181 


INOIR 


076B* 


lUBYTE 


0003 


LP 


OOOA 


T.IBSY 


071AI 


I.TSEND 


071DI 


LISINP 


07251 


LISTF 


0005 


PALT 


06B5I 


PBACKS 


06AFI 


PISTAT 


07381 


POBSY 


07281 


POIM 


073DI 


pomp 


07371 


POINSK 


073BI 


POIP 


07411 


POHASK 


072CI 


POOM 


072E1 


POOP 


07341 


POSEIID 


07331 


POSKIH 


06901 


POSTAT 


07291 


HUjINI 


07101 


PRINTT 


070DI 


IROICL 


07861 


PSCR 


06A1I 


PSCBLF 


06961 


PSFUa 


06F8I 


J«HALF 


06A8I 


PSINIT 


06E7I 


PSTD 


06BAI 


PUBSY 


074CI 


HJINP 


07521 


PUS END 


074FI 


RIBBON 


06DDI 


RTBOFF 


06E2I 


Rnr.Dow 


06C4I 


ROLIJP 


06BFI 


SOCUR 


070BI 


XBASE 


0100 


IJLCHR 


070CI 


USBl 


06C9I 


17SB2 


06CEI 


USB3 


06031 


nsB4 


06D6I 
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ACP, 1-1 
ACT-I7 

CONFIGUHING, C-2 

ADM-31 

CONFIGURING, C-2 
ADM-3A 

CONFIGURING, C-1 
ALTERNATE CHARACTER PITCH, 7-3 
ALTOS, 1-3, 2-2, 2-5 

PORT VALUES, 8-3 
ANL, 6-8 
APPLE, B-3 

AUTO CARRIAGE RETURN, 2-9 
AUTO LINE FEED, 2-9, C-1 
AUTO NEW LINE, 2-9 
AUTO NEW-LINE, 6-8 
AUTO RETURN, 6-8 
AUTO-NEW LINE, C-1 
AUTOBS:, 8-3 
BACKSPACE, 7-2 

AUTO, 8-3 
BACKSPACING OPERATING SYSTEMS, 6-9, 6-10 
BAUD SELECTION, 2-9 
BCKCHR:, 8-3 
Beehive 150, 2-1 

CONFIGURING, C-1 
BIOS, 6-5, 6-9, 6-10 

lOBYTE, 7-6 
BLDSTH:, 7-2 
BLOCK MARKERS, 5-4 
BOILT-IH PORT DHIVEH, 2-7, 3-6, 4-1, 7-6 

ALTOS, 8-3 

DETERMINE FUNCTION, 4-1 

DETERMINING OUTPUT PORT, 4-2 

DYNABYTE, 8-4 

I/O PORTS, 4-1 

INPUT DATA PORT ADDRESS, 4-4 

INPUT PORT, 4-1 

INPUT STATUS PORT, 4-4 

MEMORY-MAPPED PORTS, 4-1 

OUTPUT PORT, 4-1 

OUTPUT STATUS PORT, 4-3 

STATUS BITS, 4-1 

VECTOR GRAPHICS, 8-5 
BUSY TEST, 7-6 

USE, 7-5 
CABLING 

NEC 5510/5520, D-6 
CARRIAGE RETURN, 7-2 
CENTRONICS 

INTERFACE, 1-1 
COLOFF:, 5-3 
COMMAND KEYS, 8-1 



COMMANDS 

CONTROL- J, 5-4 
CONTROL-K, 5-4 
CONTROL-E, 7-3 
COMTROL-P, 2-6 
CONTROL-Q, 7-3 
CONTROL-R, 7-3 
CONTROL-W, 7-3 
Compucolor 800 1G, 2-1 
COMPUTER 

REQUIREMENTS, 1-1 
C0NFIG.COM, 2-6 
C0NFIGUR.COM, 2-6 
CONTROL KEYS, 5-4 
CONTHOL-H PROBLEMS, 6-9, 6-10 
CP/M LIST DEVICE, 7-6 
CP/M MEMORY SIZE, A-1 
CPM.COM, A-1 
CRBLIV:, 6-6 
Cromemco 3100, 2-1 
CONFIGURING, C-1 
CRT:, 2-7 

CSWITCH:, 7-7, 7-4 
CPU SPEED, 6-11 
CUBSOB 

BLINK FREQUENCY, 6-11 
CURSOR MOTION 
COLOFF, 5-3 
CONTROL-H, 6-10 
DELAYS, 6-9 
DELETE KEY, 6-10 
CURSOR POSITIONING, 1-1, 2-1, 6-8 
MfiMORY-MAPPED VIDEO, 6-6 
OFFSET, 6-3 
STEPS, 6-3 

USER IMPLEMENTED, 6-7 
CUSTOM CONSOLE DRIVERS 
UCNSTA:, 6-10 
UCONI:, 6-10 
UCONO:, 6-10 
COSTOMIZATIQH HOTBS,1-3,D-2,7-1,d-1,E-1,F-1 
DAISY WHEELS, 5, 4-4, D-2, D-4 
DATA INPUT PORT, 4-4 
DBLSTR:, 7-2 
DC1/DC3, D-5 
DECCHR:, 8-2 

DEFAULT CONDITIONS, 1-3, 8-1 
DEFDSK:, 8-6 
DELAYS 

SYSTEM, 6-11 
DELI:, 6-11 
DEL2:, 6-11 
DEL3:, 6-11 
DEL4:, 6-11 
DELCUS:, 6-8, 6-9 
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DELETE KET PROBLEMS, 6-9, 6-10 
DELETE LINE, 5-4, 6-7, 6-9 

DESCRIPTION, 6-5 
DELMIS:, 6-d, 6-9 
DEMONSTRATIONS, 3-1 
DETERMINE FUNCTION, 4-1 

DATA INPUT PORT ADDRESS, 4-4 

INPUT STATUS PORT, i|-4 

OUTPUT PORT, 4-2 

STATUS PORT, 4-3 
DIABLO 

1610/1620, 1-2, 2-2, 2-8, D-2, D-4 
COMPATIBLE TYPE WHEELS, D-4 
FEATURES, D-4 
INSTALLATION, D-4 
CHARACTER PITCH, D-4 

1640/50, 1-2, 2-2, D-5 

COMPATIBLE PRINT .WHEELS, D-5 
ETX/ACK, D-5 
FEATURES., D-5 .... 
FORM FEEDS, D-5 
INSTALLATION^ D-5 
DIABLO 1300, 2., 2-2' 
DIABLO HI-TTPE II, 2-2, 2-4, ?-5, 3-4, D-2 

COMPATIBLE PRINT WHEELS, D-2 
DICTIONARY, 3-1 
DISK DRIVES 

REQUIREMENTS, 1-1 
DISKETTE 

DISTRIBUTION, 3-1 
DYNABYTE . , 

PORT VALUES, 8-4 
EAKBSZ:, 7-8 

EDIT DOCUMENT PROMPT, 5-2 
ERAEOLJ, 5-4, 6-7 
ERASE-tO-END-OF-LINE, 5-2, 5t4, 6-7, 6-9 

DESCRIPTION, 6-5 
BHHOHS 

BAD FILE NAME, A-2 «.'; • . 

DIRECTORY FULL, ~A-2r ,:; -r." . 

DISK FULL, A-2 

FATAL ERROR F46, 5-3 ^ 

FILE DOES NOT EXISJ,- A-1 ^■ 

INCOMPATIBLE, A-2 

NOT ENOUGH MEMORY, A-1 

ON aOSING FILE, A-2, - 

UNEXPECTED END OF FI3LE, A-2 

WSU NOT FOUND, A-1 ." 
ETX/ACK , 2-4 , 2-8 , 7^ ,D-|» ,k-5, D-6 
EXAMPLE. TXT,, 3-1 -- " . 
FILE NAMES, 3-7 * . 

FILEC0PY.COM, B-1 
FLAG CHARACTERS, 8-1-" . . - 
Flashwriter I, 2-1 
Flaahwritep II, 2-1 



FOREIGN LANGUAGE, 8^-3 
FORM FEED, D-3, D-5 
FORM LENGTH, 2-9, D-^ 
FORMAT, B-1 

FORMATTING OPTIONS, 8-1 
H-89, B-1, E-1, F-1 
HAVBSY:, 7-5 
HAZELTINE 1500, 2-1 

AUTO LINE FEED, C-1 

CONFIGURING, C-1 

DELETE LINE, C-1 

ERASE-TO-END-OF-LINE, C-1 

INSERT LINE, C-1 

CONFIGURING, C-1 
HEATH H-89, B-1, E-1, F-1 
HETHBS:, 6-11 
HEWLETT-PACKARD 2621 A/P, 2-1 

CONFIGURING, C-1 
HI-TYPE II, D-2 (SEE DIABLO) 
HIBCUR:, 6-6 
HIBIV:, 6-6 
HIGHLIGHTIHG, 5-4 , 6-5 

CURSOR DELAY DEPENDENCE, 6-8 

MEMORY-MAPPED VIDEO, 6-6 
HITE:, 6-7 
HPR04, D-5 
HZONE:, 8-2 
I/O PORTS, 4-1 
I/OMASTER, 1-1,1-3,2-2,2-4,2-5,2-8, 

3-4,7-7,D-1,D-2 
IMSAI PI04-4, 1, 2 
IMSAI VIO, 2-1, C-1 
Infoton I-lOO, 2-1 

CONFIGURING, C-1 
INISUB:, 6-11 
INITWF:, 8-2 
INPUT STATUS PORT, 4-4 
INSERT LINE, 5-4, 6*7 

DESCRIPTION, 6-5 
INSERT-LINE, 6-9 
INSTALL, 1-3, 3-1 

ERROR 

MISSING FILE, 3-3 

PRINTER MENU, 3-4 

SIGN-ON, 3-^2 - 

STARTING : 

CONVENTIONAL, 3-2 
IHSTILLATIOH 

BUILT-IN PORT DRIVER, 4-1, 7-6 
DETERMINE, 4-1 
I/O PORT ADDRESS, 4-1 
STATUS BITS, 4-1 

BUSY TEST, 7-5 

CHANGING FILE NAMES, 3-7 

COMPLETION, 3-6 
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JHSTALLATIOH (continued) 

CONVENTIONAL, 2-1, 3-2 

CUSTOM CONSOLE DRIVERS, 6-7, 6-10 

DIABLO 1610/1620, D-4 

DIABLO 1640/1650, D-5 

DRIVER SELECTION, 3-5 

INVOKING DEFAULTS, 3-9 

LABEL PATCHER, 3-6, 3-9 

MEMORY-MAPPED VIDEO, 6-2, 6-5 

MODIFY PRE-INSTALLED WORDSTAR, 3-9 

NAME FILE & EXIT, 3-7 

NAME FILE/DRIVE & EXECUTE, 3-8 

NAMEING SOURCE FILE, 3-8 

NAMING DESTINATION FILE/DRIVE, 3-8 

NEC 5510/20, D-6 (SEE NEC, 5510/5520) 

OEM PRINTERS, D-2 (SEE PRINTER, OEM) 

OPTION Af 3-7 

OPTION B, 3-7 

OPTION C, 3-8- Sr 

OPTION D, 3-9 • ' 

OPTIONS, 3-7 ? - 

OPTIONS MENU, 3-7 

ORDINARY SEQUENCE, 3-7 

PRINTER 

CONVENTIONAL, 3-4: 

PRINTER SELECTION, 3-4 

QUME SPRINT 5, D-5 

SELECTION ERROR, 3-3 

SPECIAL SYSTEMS, 2-1 

SPECIFYING DESTINATION DISK, 3-7 

TERMINAL, 3-3, 6-2, 6-7 
CUSTOM, 3-3 
DRIVER, 6-2 
ENHANCEMENT, 6-2 

USER1, 3-9 

USER4, 3-9 
IQ-120 

CONFIGURING, C-2 
IQ-140 

CONFIGURING, C-2 
ITDSDR:, 8-2 
ITHELP:, 8-1 
ITITOG:, 8-2 
ITPOPN:, 8-2 
JUSTIFICATION 

DEFAULT FLAG, 8-2 
KEYBOARD PERFORMANCE, 7-5 
LABEL PATCHER, 3-6, 3-9, 6-1 

CHANGING MEMORY, 3-10 

INVOKING, 3-9 "..." 

LOCATION ENTRY, 3-10 
LABELS:, 6-1 > 

Lear-Siegler ADM-31., 2-1 

CONFIGURING, C-2 



Lear-Siegler ADM-3A, 2-1 

CONFIGURING, C-1 
LINDEL:, 6-7 
LINE FEED, 7-2 
LININS:, 6-7 
LISINP:, 7-6 
LISTINGS 

USER AREAS DESCRIPTION, 6-1 

USER1, 3-9, 6-7, E-1 
DESCRIPTION, 6-1 

USER4, 3-9, 7-1, F-1 
DESCRIPTION, 6-1 ; 
LOCAL LINE FEED, 2-9 
MAILMRGE.OVR, 3-1 
MARKERS, 5-4 
MEMADR:, 6-6 
MEMAPV:, 6-6 
MEMORY 

REQUIREMENTS, 1^2; 
MINIMUM^ 1-2 - ;. .: ■ 
MEMORY-MAPPED PORTS, 4*1 
MEMORY-MAPPED VIDEO, 6-2, 6-5 

CRBLIV:, 6-6 

CURSOR POSITIONING, 6*6 " 

CUSTOM CONSOLE DRIVERS, 6-7, 6-10 

DIRECT STORAGE, 6-6 

HIBCUR:, 6-6 

HIBIV:, 6-6 

HIGHLIGHTING, 6-6 

IMSAI VIO, C-1 

MEMADR:, 6-6 

MEMAPV:, 6-6 

REQUIREMENTS, 6-5, 6-6 

SWIN:, 6-6 

SWOUT:, 6-6 
MENUS, 2-1 

DELAYS, 6-11 _ . 

MAIN, -5-3 ' - . 
MERGE PRINT, 3-1 ^ 
MESSAGES, 3-1, 8-1 
MicroTerm ACT-IV, 2*1 

CONFIGURING,.. C-2 
MioroTerm ACT-V, 2-1 
MQDIFICAIIQHS • 

AUTOMATIC BACKSPACE CHARACTER, 8-3 

DECIMAL CHARACTER SELECTION, 8-2 

DIRECTORY DISPLAY TOGGLE, 8-2 

DOCUMENT/NONDOCUMKIT DEFAULT, 8-3 

FOR BACKSPiciNG DOS», 6-9, 6-10 

HELP LEVEL, 8-1 

HELP LBViEL pOMPT, 8-1 

HYPHEN-HELP DEFAULT, 8-2 

HYPHEN-HELP RANGE, 8-2 

INSERT TOGGLE DEFAULT, 8-2 

JUSTIFICATION DEFAULT, 8-2 
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MQDIFICATIOBS ( continued ) 
MAILMHGE 

FIELD SEPEBATOR SELECTION, 8-2 
VARIABLE DELIMITER SELECTION, d-2 
MP/M, 8-5 

DEFAULT OVERLAI RESIDENENCB, 8-6 
DIABLE RESET ON EXIT, 8-5 
ENABLE SYSTEM aOCK, 8-5 
NUMBER OF USERS, 8-6 
OMOIT-PAGE-NUlfflERS DEFAULT, 8-2 
PATCHING, 6-1 

USE FORM FEEDS D^AULT, 8-2 
MORPAT:, 6-11 
M07CPM.COM, A-4 
MP/M, 8-5 
NEC 

551 0/5520 »t-2, 2-2, 2-8, D-5 
XON/XOFF SWITCH, fi-6 
CABLE ADAPTOR, D-6 
ALTERNATE CHARACTER SET, D-5 
CONFIGURING, D*6 
ETX/ACK SWITCH, D-6 
FEATURES, D-5 
HUM/BUZZ, D-6 
INSTALLATION, D-6 
SPECIAL CABLING, D-6 
5500D, ;i-S, 2-2, 2-4, 2-5, 3-4, 7-1, D-2 

E INTERFACING, D-2 
5530, 2-4 
NITHIJ':,--8-r • 

NMOFUS:, 8-6 , 

NO FJI.es BEING EDITED MENU, 5-1 
NONDOC:, 8-3 

OEM PRINTERS, 1-1 ■-<SE^ PRINTERS, OEM) 
OPTIONS - - ,r 

INSTALLATION,- :3-7^ 
ORG 4300, B-2, E-1 , F-1 
PA-1, 1-3, 2-2, 2-4, 2-5,-2-8 
PALT:, 7-3 - ' ~ -' ^' . . ' 
PARALLEL, D-1 *-'>.,. 

PARITY, 2-9,'" ' ' ' ' - ' ' ' 
PATCHIHG, 2-1 ,6-1 

ADDITIONAL PATCH- AREAS ,6-11 

BACKSPACING OPERATING SYSTEMS, 6-1 

BACKSPACING SYSTEMS,- 6-9, 6-10 

DDT.COM, 6-1, 6-11 .- '• 

DEFINITION, 6-1 • 

DISPLAY IN LAST GOL'tfMN, 6-1 

LABEL PATCHER, 6*1 

MEMORY-MAPPED VlfiEO, •6-6-' 

0VElSTRIKE^;'f-1 ' ^. .•' 

SUBROUTINES, 6-11--' " -' 
PBACKS:, 7-2 
PBGMEM:, 6-11 
Perkin-Elmer 550 (Bantam), 2-1 



PHANtOM RUBOUT, D-4, D-5 
PHANTOM SPACE, D-4, D-5 
PI04-4, D-1, D-2 
PITCH, 7-3, D-3 
PODBLK:, 8-2 
PORT DRIVER, 2-7 
POSMTH:, 7-2 
PRE-INSTALLED, B-1, B-2 
PRFINI:, 7-4 
PRINIT:, 7-4 
PRINT 

BOLDFACE, 2-2 

CARIABLE CHARACTER PITCH, 2-3 

DOUBLE STRIKE, 2-2 

INCRMENTAL 

HORIZONTAL MOTION, 2-2 
VERTICAL MOTION,; 2-2 

JUSTIFICATION \/ 
MICROSPACE, ^-2 I 
WHOLE SPACE, 2-3 

OVERPRINT, '2-2 

STRIKEOUT, 2-2 

SUBSCRIPT, 2-3 

SUPERSCRIPT, 2-3 

UNDERLINE, 2-2 

VARIABLE LINE HEIGHT, 2-3 
PRINT WHEEELS, D-5 
PR INT WH EELS, D-2 
PRIHTBS 

8-BIT PARRALEL INTERFACE, D-3 

ADDITIONAL FEATURES, 7-1 

ADVANCE TO NEXT LINE STRING, 7-2 

ALTERNATE CONSOLE DRIVER, 7-5 

ANY TELETYPE-LIKE, b-7 

AUTO CARRIAGE RETURN, D-3 

AUTO LINE FEED,' D-3 

AUTO-LINE FEED., 2-3 

BACKSPACE, 7-1 , 7^2 

BACKSPACING, '2r3:' 

BACKSPACING XELlTYPE LIKE, 7 

BOLDFACE,.. 7-1 :: 

BLDSTR:, 7-2 ' 
BUFFER OVERFLOW, 2-4 
BUFFER-FULL LINE, 2-8 
BUILT-IN PORT' DRIVER, 7-6 

BUSY TEST, 7^:,.;. 

BUSY TEST FLAG, "7^5 
CABLING, 2-4, 2-8 
CENTRONICS INTERFACE, 3 
CHARACTER INPUT, 7-6 
CHARACTER OUTPUT, 7-6 
CHARACTER PITCH, D-3 
CONFIGURING, 2-9 

AUTO CARRIAGE RETURN, 2-9 
AUTO LINE FEED, 2-9 
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PRUITKU (continued) 
AUTO NEW LINE, 2-9 
FORM LENGTH, 2-9 
LOCAL LIN& FEED, 2-9 
PAHITT, 2-9 
PROTOCOL, 2-9 
SPEED SELECTION, 2-9 
TOP-OF-FORM, 2-9 
CP/M LIST DEVICE, 7-5 

CP/M SET-UP, 2-6 
CP/M LIST DVICE 
STAT.COM, 2-6 
CUSTOM DRIVER, 7-5 
DAISY-WHEEL, 2-2, D-1 
1200 BAUD, 2-8 
300 BAUD, 2-8 
CHARACTERISTICS, 2-1/ 
POSMTH:, 7-2 
TYPE WHEEELS, D<^1 : . 
DOUBLE STRIKE, 7-1 / ^ 
DBLSTR:, 7-2 ' 
ALTERNATE CONSOLE, 2-$ , 7-6 
BUILT-IN 

ALTOS, 8-3 

DYNABYTE, 8-4 

VECTOR GRAPHICS, 8-5 
BUILT-IN PORT, 2-8, 3.-6, 4-1 

INPUT STATUS, 4A' 

STATUS, 4-3 
BUILT-IN PORT DRIVER, 2-7 
BUSY TEST, 2-7 
CP/M LIST DEVICE, 2-5, 3-5, 7-6 

TESTING, 2-6 
CRT: DEVICE, 2-7 
CSWTCH:, 7-4 . 

DETERMINING OtJTPUT POST, 4-2 
ENTRY POINTS, 7-5^ ^. 
FLAGS, 7-4 \ 
I/O PORTS, 2-7^ 4-1 
INPUT DATA PORT^ ,4-4. 
INSTALLATION,, 3^5 , 
MEMORY-MAPPED,' 'a-r . . « ', 
MEMORY-MAPPED PORTS, 4-r 
OEM, 7-7 - - 

PORT " '. 

INSTALLATION, 2-7 
PORT ADDRESSES, 2-7 ^ * 
PRINTER BUSY TEST, 2-5 
SELECTION, 3-5 
SPINWARE, 2-5, 2-8 , ' 
STATUS BITS, 2-7 
TTY: DEVICE, 2-7 
USER SUPPLIED, 7-7 



DRIVERS, 1-3, 2-2, 2-5, 2-8 
CP/M LIST DEVICE, 2-5.::rr 1-: 

EDIT & PRINT, 7-5 
ETX/ACK, 1-3 

FORM FEED, D-3 .....: S i- 
FORM LENGTH, D-3 
FUNCTION STRINGS, 7-2 '; : :, 
HALF-LINE FEED, 2^V 7^3, D-8 
HANGING, 7-5 :"■ m7c..\:. :;:.:.- 
INSTALLATION- :-ja^-Z \Z ^.-':':'-^ 
... CONVENTIONAL^ 3rt'^^ - i .; ' 

PROTOCOL, 3-5 

SELECTION, ■,3«4::. ^G-Tl v')-'\ : '•' 
LINE SPACING, D-3 
LOST CHARACTERS, 2-4.. . -: ■ 
MODIFICATIONS, 7-1 
NON-RETURN, D-7 
OEM,, 1-3, 2-2,-2-4, 2-8/ 3-^, 7-7, D-2 

DATA 1/2 BIT^ D-2 

DRIVER, 2-5 

-INSTALLATION, D-2 

INTERFACE, D-1 

INTERFACING, D-2 

TYPE WHEELS, D-1 
OPTIONS 

ALTERNATE CHARACTER PITCH, 7-3 

DEINITIALIZATION STRING, 7-4 

DEINITILIZATICN SUBROUTINE, 7-4 

HALF-LINE ADVANCE STRING, 7-3 

INITIALIZATION STRING, 7-4 . 

INITIALIZATION SUBROUTINE, 7-4 

RIBBON COLOR CHANGE, 7-4 

STANDAI© CH^A^TER PITCH, .7-3" ^^ 

SUBSCRIPT, 7-3 

SUPBRCRIPTi: 7-3 

USE FORM FEEDS, 2-9 

USER CONTROL STRINGS, 7^-3 ' 
OTHERS, 7 - « ' '.'-: 
0VERSTHIKE,'^7r1 »: 
PRINTER BUSY LINE, 2-8 ^ 
PROTCOL FLAGS, 7-7 
PROTOCOL, 2-2, 2-7, 3-5, 7-5, 7*7 ■ 

BAUD, 2-4 

BUFFEH^SJZE", 7-8 
, BUILT-IN^ PORT DRIVER, 4-4 

CP/M?iLJST DpiCE, 2-4 

ETX/ACK, 2-4, >2-8 

REQUIREMENTS, 2-9 

USER-SUPPLIED DRIVER, 7-7 

XON/XOFF, 4, 2--4 
REQUIREMENT?, 1.-3t^ 
RETURN TO START OF LINE, STRING ^ 7-2 
REVERSE CHANNEL, 2^8 
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PBINTKU (continued) 
jSERIAL, 1«a 
' lBAtJD/2-^ 

DAIST-W^&y 2-2 
PROTOCOL, 2-4 
SERIAL DAIST, b-3 
CONTROI^S, D-3^. 
INSTALLATION, D-3 
PROTOCOL, D-3r " ^ c 
SPECIAL FUNCTIONS, 7-3- . 
SUBSCRIPT, 7-3 
SUPERSCRIPT, 7-3 

TELETYPE-LIZE, 1-3, 2-2, 2-8, D-7 
AUTO LINE FEED, D-7 
CAPABILITIES, D-7 
CHARACTERISTI,CS.. 2-1 ~ 
MENU SELECTIONS, ,2-3 - - ^ 
TESTING, 5-5 "^ ' • .- " 
TOP OF FORM, -4D-3 , _ 
UNDERLINE, 7-1 I. - - 
USER4, 6-1 . . P , 
PRINTER DRIVER MENU, 3-5 
PRINTER MENU, 3-4 
PRINTER SELECTION 

ERROR, 3-4 
Processor Tech Sol, 2-1 
PROCESSOR TECHNOLOGY VDM/SOL 

CONFIGURING, C-2 
PROTa:,. 7-7 
PHOTOCOL, ^-9, 3-5^, 7-6, "7r7, D-3 

BUILT-IN PORT DHIVEH, 4-4 (see BUILT-IN) 

BUSY TEST, 7-5 

DC1/DC3, D-5 ' ' 

DEFINITION, 2-4 ■ . \* 

DIABLO 1640/1650, D-5 " (SEE DIABLO) 

DIABL01640/1650 (SEE DIABLO) 

XON/XOFF, D-5 • 
ETX/ACK, 2-4, 7-8, D-4,. D-5,t P«^ 
BUFFER LENGTH, 7-1 ^ ^-^ ," ^ ^' 
INSTALLATION, 3-5 ' 'C. 
MENU, 3-5 - - * ^ ~l .^\ 
SELECTION, 3-5 '- ^' 
XON/XOFF, 2-4, d'^f^'OrS' 
PSCR:, 7-1, 7-2 

PSCRLF:, 7-2 , . ^ ^ ^ " 
PSFINI:, 7-4 .^1 

PSHALF:, 7-3 ^ - • v '' - 
PSINIT:, 7-4 " , " \ '\ 
PSTD:, 7-3 
PUBSY : , 7-7 
PUINP:, 7-7 



QUME 

SPRINT 5, 1-2, 2-2, D-5 

COMPATIBLE TYPE WHEELS, D-5 
ETX/ACK, D-5 
INSTALLATION, D-5 

SPRINT 3, 1-2, 2-2> 2-4, 2-5, 3-4, I 
COMPATIBLE PRINT WHEELS, D-2 
INTERFACING, D-2 
RADIO-SHACK , : B^ , : n 
RAM, 1-2 

RELOCCOM, A-1 r. ' 
RELOCATING MEMORY, A-1 
REQUIREMENTS 

TERMINAL, 6-2 
RFIXER:, 6-10'- - 
RIBBON COLOR, 7-4 ': 
RIB0FF:,i7-4.- ■-;^./ 
RIBON:, 7-4 

ROLDOW:, 7-3 ^^ ■■ 

ROLUPi, 7-3 '-' 

RSTFLG:, 8-5 -" 

RUBFXF:, 6-10 
RUBOUT, D-4 
RULER LINE, 5->3, 5-4 
RVELIM:, 8-2 
SCREEN DIMpafSIONS, 6-7 
SERIAL, 1-1 
SET-UP ^ - . 

SYSTEM DISKETTE, ^ml 
S ETUP .COM, 2-6 
SHIFT-IN, D-5 

SHIFT-OUT, j)-5 >:: : J.: 

SOL 

CONFIGUMNa,.C*.Z- ■ 
SOROC 10-120 

CONFIGUR33rc^ X^- ■ 
Soroc IQ-120,C'2*-1 - S 
SOROC 10-140 '-^^ 

CONFIGURING, C-2 --^ 
SPACE, 4 c 
SPECIAL FEATURES;,c€*3 " 
SPECIAL INSTALLATIONS, 3-9 
SPECIAL TEHSiraS^ B-1 

APPLE, B-3 i-'h HC^ 

H-89/2-89, B-1 
r rORG 4300 i: B-t: > 

TRS-80.MD0EL I. KEYBOARD, B-2 

TRS-eO MODEL. ly B^2 
. > TRS-80"^DEL I KEYBOARD TABLE, B-2 
SPELLINdy 3-1 " 
SPELSTARiDCr; 5-T 

spelstar.07r;-3-i 

SPINWARE, 2-5, '2-8 - 

SPRINT 3, D-2 (SEE PRINTER, QUME) 

SPRINT 5, D-5 (SEE PRINTER, QUME) 
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STANDABD CHAflACTEH PITCH, 7-3 
SUBROUTINES, 6-11 
SUBSCRIPT, 7-3 
SUPERSCRIPT, 7-3 
SWIN:, 6-6 
SWOUT:, 6-6 
SWTPC CT-82, 2-1 
STSGEN.COM, B-i: 
TABLES 

DEFAULTS FOR PARAMETERS, T-4-C 
TCKFLG:, 8-5 

TEC Model 571, 2-1 - . £ 
TEHMIHAL 

ADM-31, C-2 - 

CONFIGURING 

AUTO LINE FEED, C-1 - 
BEEHIVE 150, C-1 
BRIGHTNESS ADJUSTMENT, 5-4 
CONFIGURING 

AUTO-NEW LINE, 6-8 
CONTROL CODES, 6-2 
CROMEMCO 3100, C-1 
CURSOR MOTION 

DELAYS, 6-8, 6-9 
CURSOR POSITIONING, 5-3, 6-2, 6-3, 6-7 
OFFSET, 6-3 

STEPS FOR ANia.ISIS, :6i-3i " 
SUBROUTINE, 6-11 
CUSTOM DRIVERS, 6-5, 6-7, 6-10 
CUSTOM INSTAI^*ATION, 3-3, d-2^ 6-7 
DELAYS, 6-8 
DELETE LINE, 5-4 

DRIVER INSTALLATION, 6-2 »^ 
ENHANCEMENT, 6-2 
EHASE-TO-END-OF-LINE, 5-4 " 
HAZELTINE 1500, C-1 
HEWLETT-PACKARD 2621 AVP,- C-1 
HIGHLIGHTING, 5-4, 6-5 
INFOTON 1-100, C-1 
INSERT LINE, 5-4 ^ 
INSTALL MENU, 3-3 

LEAR-SIEGLER ADM-.3A, C-1 " 

MEMORY-MAPPED VIDEO^ 6-2 
MICROTERM ACT-IV, C-2-. 
MODIFICATIONS FOR, 6-2 
OPTIONS, 6-2 

DEINITIALIZATION SUBROUTINE, 6-11 
DELETE LINE, 6-5," 6-7, 6-9 ' " 
DISPLAY IN LAST COLUMN, ^6-8 "' 
ERASE?.TO-END-OF*LINE, 6-5, 6'*-7; 6-9 
INITIALIZATION STRING,- .6^8' . 
INITIALIZATION SUBROUTINE, 6-.-11 -> 
INSERT LINE, 6-5, 6-7, 6-9 -' -^ *»• 
OPTIONS SWITCHES, 2-1 
PATCH AREA, 6-7 - « 



PATCHING 

INTRODUCTION, 6-2 

PROCEDURE FOR DETERMJ^TING DELAYS, 6-8 

REQUIREMENTS, 1-1, 6-2 
MEMORY, 1-2 

SCREEN DIMENSIONS^-, 6-7 

SCREEN SIZE, 6-2 

SCREEN UPDATE SPEED, 6-9 

SELECTION, 3-3' ~ ' 

SOROC IQ-120, 0-2": " 

SOROC IQ-140, C-2 

UNUSUAL, 6-4 

USELST: 

REQUIREMENTS, 6-8 

USER1, 6-1, 6-7 " 
TESHHG 

CURSOR POSITIONING, 5-3 

DELETE LINi,-5-i4 - 

ERAEOL:, 5-4 

ERASE-TO-END-OF-LINE, 5-4 

HIGHLIGHTING, 5-4 

INSERT LINE, 5-4 

PRINTER, 5^' 

WORDWRAP, 5-4 
THIMBLES, D-1 
TOP OF FORM, D-3 
TOP-OF-FORM, 2-9 
TRMINI:, 6^8 

THS-80 MODEL 1, B-2, E-1 
TRS-80 MODEL 2, 1-3, 2-2, 2-5, F-1 
THSCIP:, 6-11 * 

TRSCRS:, 6-11 ^' \ ^ 

TTT:, 2-7 

TYPE WHEELS, D-1, D-2, D^, D-5 
UCNSTA:, 6-10 ' \. 

U^IdNlV; ^6^0 '''"''- ^ , ' ' 
UCONO-^^ 6^10 

UCRPOS:, 6-7, 6-11 ' ' 
UNiSUBV; S-11 - ^ ' 
USE FORM FEEDS, '5 - . / .. . 
USELST:, 6-8 ^ t 

USER MODIFICATIONS, 3-6 . 

CONVENTIONAL, ^-9 
USER1, 6-7, ^6^1 or E-1 

INISUB:, 6-11 

MORPAT:, 6-11 . . ' ..,,.; 

PBGMEM:, 6-11 T ' ; : ".' 

SCREEN DIMENSIONS, 6-7 ' . ^'^'^TZ..,^ 

UCRPOS:, 6-7, 6-11 ^ „ : ^t 
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USEH4, F-1 
BLDSTR:, 7-2 
CSVriTCH:, 7-7 
CSWTCH:, 7-4 
DBLSTH:, 7-2 
EAKBSZ:, 7-8 
HAVBSY:, 7-5 
LISINP;, 7-6 
PALT:, 7-3 
PBACKS:, 7-2 
POSMTH:, 7-1, 7-2 
PRFINI 
PRINIT 
PROTCL 



7-4 

7-4 

7-7 
PSCH:, 7-2 
PSCHLF; 



7-2 

7-4 
7-3 

7-4 



PSFINIi 
PSHALF: 
PSINIT: 
PSTD:, 7-3 
PUBSY:, 7-7 
PUINP:, 7-7 
RIBOFF:, 7-4 
RIBON:, 7-4 
ROLDGW:, 7-3 
ROLUP:, 7-3 

aSR1:/USH4:, 7-3 
UTILITIES 

MAIL MERGE, 3-1 

SPELLING, 3-1 
VAHCH1:, 8-2 
7ARCH2:, 8-2 
VDM 

CONFIGURING, C-2 
VECTOR GRAPHICS 

PORT VALUES, 8-5 
VERSIONS 

SPECIAL, 2-1 
VIDEO BOARD (SEE MEMORY-MAPPED VIDEO ) 

REQUIREMENTS, 1-1 
Visual 200, 2-1 
WID:, 6-7 
WORD WRAP, 5-4 
WORK DISK, 3-1 
WS.COM, 3-7, A-1 
WSMSGS.OVR, 3*1, 5-2 
WS0VLY1,0VR, 3-1, 5-3 
WSU.COM, 3-1, 3-7, A-1 
XON/XOFF, 2-4, D-4, D-5 
Z-89, B-1, F-1 
Z-89X, B-1 
ZAFCIN:, 6-10 
ZENITH Z-89, B-1, E-1, F-1 
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